Jest CLI Options

El comando jest tiene varias opciones útiles. Puede ejecutar jest --help para ver todas las opciones disponibles. Muchas de las opciones que se muestran a continuación se pueden utilizar también de forma conjunta para ejecutar las pruebas exactamente de la manera que desea. Cada una de las opciones de la configuración de Jest puede especificarse también a través de la linea de comandos.

A continuación se muestra un breve resumen:

Ejecución desde la línea de comandos #

Ejecuta todos las pruebas (por defecto):

jest

Ejecuta sólo las pruebas que se especificaron con un patrón o un nombre de archivo:

jest my-test #or
jest path/to/my-test.js

Ejecuta las pruebas relacionadas con los archivos modificados basados en hg/git (archivos no confirmados):

jest -o

Ejecuta las pruebas relacionadas con path/to/fileA.js y path/to/fileB.js:

jest --findRelatedTests path/to/fileA.js path/to/fileB.js

Ejecuta pruebas que coincidan con el nombre especificado (coinciden con el nombre en el describe o test).

jest -t name-of-spec

Ejecuta el modo "en la mira":

jest --watch #runs jest -o by default
jest --watchAll #runs all tests

El modo "en la mira" también permite especificar el nombre o la ruta de un archivo para centrarse en un conjunto específico de pruebas.

Uso con scripts npm #

Si ejecuta Jest a través de npm test, puede utilizar los argumentos de la línea de comandos insertando un -- entre npm test y los argumentos Jest. En lugar de:

jest -u -t="ColorPicker"

puedes usar:

npm test -- -u -t="ColorPicker"

Las opciones CLI toman precedencia sobre los valores de Configuración.

Opciones #

Referencia #

jest <regexForTestFiles> #

Cuando corres jest con un argument, ese argumento es tratado como una expresión regular para coincidir con los archivos de tu proyecto. Es posible correr suits de pruebas proveyendo un patrón. Solo los archivos que coinciden con el patrón serán seleccionados y ejecutados. Nota: dependiendo de la terminal usada, puede ser necesario usar el siguiente argumento entre comillas: jest "my.*(complex)?pattern.

--bail #

Alias: -b. Finaliza la suit de pruebas inmediatamente luego de la primera prueba fallada.

--cache #

Si deseas usar la caché. Por defecto es verdadero. Desactiva la caché usando --no-cache. Nota: el caché debería ser desactivado sólo si estas experimentando problemas relacionados con el caché. En promedio, desactivar la caché provoca que Jest sea por lo menos dos veces más lento.

If you want to inspect or clear the cache, use --showConfig and look at the cacheDirectory value.

--ci #

Cuando se activa esta opcion Jest asume que se esta corriendo en un entorno de Integración Continua CI. Esto cambia el comportamiento cuando se encuentra un nuevo snapshot. En lugar de guardar el nuevo snapshot automáticamente, como lo hace normalmente, Jest fallará la prueba y requerirá que se ejecute nuevamente con la opción --updateSnapshot.

--collectCoverageFrom=<glob> #

Relacionado con el directorio raíz, los archivos de información de cobertura debe ser de coincidencia de patrón de global.

--colors #

Resultados forzados de pruebas se muestran resaltados incluso si stdout no es un TTY.

--config=<path> #

Alias: -c. La ruta a el archivo de configuración de jest especificando como encontrar y ejecutar las pruebas. Si no está rootDir definida en la configuración, se asume que el directorio actual es el rootDir para el proyecto. Esto también puede ser un valor codificado en JSON que Jest usará como configuración.

--coverage #

Indica que información de cobertura de prueba debería ser recolectada y registrada en la salida.

--debug #

Imprime información de debugging para tu configuración jest.

--env=<environment> #

El entorno de prueba usado por todos los tests. Este puede ser el punto para cualquier archivo o módulo node. Ejemplos: jsdom, node o ruta/a/mi-entorno.js.

--expand #

Alias: -e. Usa esta opción para mostrar todas las diferencias y errores en vez de un parche.

--findRelatedTests <spaceSeparatedListOfSourceFiles> #

Encuentra y corre las pruebas que cubren una lista de archivos fuentes separados por espacios que fueron pasados como argumentos. Útil para la integración de un pre-commit hook para correr la minima cantidad de pruebas necesarias.

--forceExit #

Fuerza a Jest a salir después de que todos las pruebas completen su ejecución. Esto es útil cuando los recursos asignados por el código de la prueba no pueden ser adecuadamente limpiados. Nota: Esta característica es un atajo. Si Jest no termina de ejecutar al final de la corrida de pruebas, quiere decir que hay recursos externos que todavía están siendo retenidos. Se aconseja liberar los recursos externos después de cada prueba para asegurar que Jest pueda cerrarse apropiadamente.

--help #

Muestra la información de ayuda, similar a esta página.

--json #

Imprime los resultados de las pruebas en JSON. Este modo enviará todos las otras salidas de la prueba y mensajes de usuario al stderr.

--outputFile=<filename> #

Escribe los resultados de las pruebas en un archivo cuando la opción --json es también especificada.

--lastCommit #

Correrá todos las pruebas afectadas por los cambios de los archivos del último commit hecho.

--listTests #

Dados unos argumentos, jest lista todos los test como un JSON. Puede ser usado junto --findRelatedTests para saber que test se van a ejecutar.

--logHeapUsage #

Registra el uso de la pila despues de cada test. Útil para depurar perdidas de memoria. Úselo junto con --runInBand y --expose-gc en node.

--maxWorkers=<num> #

Alias: -w. Especifica el número máximo de trabajadores que el pool de trabajadores creará para correr las pruebas. El valor por defecto es igual al número de núcleos disponibles en tu equipo. Puede ser útil ajustar esto en entornos de recursos limitados como CIs, pero el valor predeterminado debe ser suficiente para la mayoría de los casos de uso.

--noStackTrace #

Desactiva el stack trace de la salida de los resultados de las pruebas.

--notify #

Activa las notificaciones de resultados de la prueba. Es bueno para cuando no quieres que tu conciencia pueda concentrarse en nada más que pruebas de JavaScript.

--onlyChanged #

Alias: -o. Intenta identificar qué pruebas debe correr de base de qué archivos cambiados del repositorio actual. Sólo funciona si está ejecutando las pruebas en un repositorio de git/hg en el momento y requiere un grafo de dependencia estática (es decir, no requiere dinámica).

--projects <project1> ... <projectN> #

Ejecuta tests de uno o más proyectos.

--runInBand #

Alias: -i. Ejecuta todas las pruebas en serie en el proceso actual, en lugar de crear un grupo de trabajadores de procesos hijo para ejecutar pruebas. Esto puede ser útil para la depuración.

--setupTestFrameworkScriptFile=<archivo> #

Ruta que apunta a un modulo que ejecuta código para configuración inicial necesaria que el framework ejecute antes de cada prueba. Se tiene que tener en cuenta que los archivos importados por el script de configuración inicial no serán sustituidos por mocks durante pruebas.

--showConfig #

Imprime tu configuración Jest luego finaliza el programa.

--silent #

Previene a las pruebas de imprimir mensajes a través de la consola.

--testNamePattern=<regex> #

Alias: -t. Corre solo las pruebas con el nombre que coincide con la expresión regular.

--testPathPattern=<regex> #

Una expresión regular que coincide con todas las rutas de las pruebas antes de ejecutar la prueba.

--testRunner=<ruta> #

Te permite especificar un corredor de prueba personalizado.

--updateSnapshot #

Alias: -u. Utiliza esta bandera para volver a grabar cada instantánea que falla durante esta prueba. Puede utilizarse conjuntamente con un patrón de prueba de la suite o con --testNamePattern para volver a grabar instantáneas.

--useStderr #

Desvía toda la salida a stderr.

--verbose #

Muestra los resultados de la prueba individual con la jerarquía de la suite de prueba.

--version #

Alias: -v. Imprime la versión y finaliza.

--watch #

Vigilar archivos para los cambios y volver a ejecutar pruebas relacionadas con los archivos modificados. Si quieres volver a ejecutar todas las pruebas cuando un archivo ha cambiado, utiliza la opción --watchAll en su lugar.

--watchAll #

Vigila los archivos para los cambios y ejecuta todas las pruebas cuando algo cambia. Si deseas volver a ejecutar sólo las pruebas que dependen de los archivos cambiados, usa la opción --watch.

--watchman #

Se utiliza para usar el vigilante para rastreo de archivos. Por defecto es verdadero. Desactivar usando --no-watchman.