Ejecuta las pruebas de servidor: toda la pila de la aplicación, incluida la base de datos.
Sintaxis
$ vela test:server$ vela test:server petsEs vitest run --project server con los valores por defecto de vela: el reporter de puntos, modo CI y un resultado correcto con una suite vacía. npm run test:unit ejecuta el otro proyecto; npm test ejecuta ambos. Un argumento posicional simple filtra qué pruebas se ejecutan, y cualquier otro argumento se pasa directamente a Vitest. El comando termina con un código distinto de cero cuando falla una prueba, así que puede usarse como puerta en CI.
Sin un filtro tuyo, un proyecto que todavía no tiene pruebas de servidor pasa — el estado en que queda un proyecto justo después de vela enable backend. Un filtro que no coincide con ningún archivo de prueba sigue fallando.
Los servidores
Los servidores que necesitan las pruebas los arranca el propio Vitest, no este comando. vitest.config.ts nombra vela/testing como global setup:
test: {
name: 'server',
globalSetup: ['vela/testing'],
setupFiles: ['test/setup.ts']
}Antes del primer archivo de pruebas:
- Crea una base de datos PocketBase desechable bajo
test-data/, con todas las migraciones aplicadas y los hooks de la aplicación cargados - Carga en ella los seeds y después los fixtures
- Inicia un servidor de Vite con los componentes de página sustituidos por stubs
Después del último, detiene ambos y elimina la base de datos. Los dos corren en un proceso propio, iniciado desde el vela que el proyecto tiene instalado, de modo que el servidor de Vite de la aplicación nunca comparte proceso con el de Vitest.
Como el setup forma parte de la configuración de Vitest, los mismos servidores arrancan con npm test, npx vitest, npx vitest --watch y el ejecutor de pruebas de un editor. En modo watch permanecen activos durante toda la sesión: la base de datos se crea una vez, y las pruebas limpian lo suyo. Cada ejecución tiene su propio directorio bajo test-data/, así que una sesión watch en el editor y una ejecución en la terminal no comparten base de datos. Los directorios que deja una ejecución que murió los elimina la siguiente.
Archivos de prueba
Las pruebas de servidor son los archivos llamados server.test.ts o <nombre>.server.test.ts bajo src, y se ejecutan en el proyecto de Vitest llamado server; cualquier otro archivo de prueba es una prueba unitaria. Las pruebas de componentes — *.svelte.test.ts — quedan excluidas de ambos. Los generadores escriben un server.test.ts junto a las rutas que crean, y un <name>.server.test.ts junto a cada workflow; una prueba de workflow arranca un worker en el proceso de pruebas, así que la ejecución se completa ahí. vela generate form y vela enable ai solo escriben la suya cuando el proyecto tiene supertest instalado.
Las pruebas de servidor llegan a la aplicación por HTTP y no importan nada de ella, así que el watcher de Vitest no puede saber a qué pruebas afecta un cambio en una ruta. La configuración lista src/routes, src/lib/server, src/hooks.server.ts y data/hooks en forceRerunTriggers, y un cambio ahí vuelve a ejecutar toda la suite.
Contexto de prueba
test/setup.ts da a cada prueba un usuario nuevo y un conjunto de clientes, de modo que las pruebas se leen como peticiones HTTP contra la aplicación en ejecución. vela enable backend lo crea, junto con el vitest.config.ts que lo carga, en un proyecto que no tiene ninguno de los dos:
request- Un cliente de supertest, sin autenticaragent- Un agente de supertest que conserva las cookies, conauthenticateUser()admin- El cliente de administración de PocketBasepb- El cliente de PocketBase con ámbito del usuario de pruebauser- El registro de usuario creado para esta prueba
El archivo de setup encuentra los servidores con inject('vela'), que da la URL de PocketBase, la URL de la aplicación, las credenciales del superusuario y el directorio de datos de la ejecución. Los mismos valores están también en el entorno, para el código que lo lee: POCKETBASE_URL, POCKETBASE_SUPERUSER_EMAIL, POCKETBASE_SUPERUSER_PASSWORD, VITE_TEST_URL, VELA_DATA_DIR y TEST=true. El .env del proyecto se carga primero, como lo carga cualquier comando de vela, sin reemplazar nada que ya esté definido. Las variables definidas en test.env de la configuración llegan a la aplicación además de a las pruebas.
Frontend
Los componentes de página, layout y error se sustituyen por stubs durante la ejecución. Las pruebas de servidor solo se ocupan del backend y la base de datos, y saltarse el bundle del frontend supone una gran ganancia de velocidad.
Seeds y fixtures
La base de datos de pruebas no está vacía. Tras las migraciones se carga cada archivo de data/seeds y después cada archivo de data/fixtures, a través del mismo servidor con el que hablan las pruebas — así los hooks de la aplicación se aplican a estos registros como a cualquier otra escritura. Un registro que el esquema actual rechaza detiene la ejecución y aparece nombrado en el error; vela fixtures regen reescribe los fixtures a partir del esquema.
Los archivos de prueba se ejecutan en paralelo contra una única base de datos, así que trata los seeds y los fixtures como una base de solo lectura: léelos y busca registros por id, pero crea tus propios registros para todo lo que una prueba modifique o elimine. Las pruebas generadas ya funcionan así.