CLI.md

id	title	layout	category	permalink	previous
cli	Jest CLI Options	reference	API Reference	docs/cli.html	configuration

The jest command line tool has a number of useful options, although you might never need any of them. You can run jest --help to view the options available. This document will also provide a brief overview.

If you run Jest via npm test, you can still use the command line arguments by inserting a -- between npm test and the Jest arguments. So instead of:

jest -u -t="ColorPicker"

you could use:

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

CLI options take precedence over values from the Configuration.

Options

<AUTOGENERATED_TABLE_OF_CONTENTS>

---

Reference

jest <regexForTestFiles>

When you run jest with an argument, that argument is treated as a regular expression to match against files in your project. It is possible to run test suites by providing a pattern. Only the files that the pattern matches will be picked up and executed.

--bail

Alias: -b. Exit the test suite immediately upon the first failing test.

--cache

Whether to use the transform cache. Defaults to true. Disable the cache using --no-cache.

--collectCoverageFrom=<glob>

Relative to the root directory, glob pattern matching the files that coverage info needs to be collected from.

--colors

Forces test results output highlighting even if stdout is not a TTY.

--config=<path>

Alias: -c. The path to a jest config file specifying how to find and execute tests. If no rootDir is set in the config, the current directory is assumed to be the rootDir for the project. This can also be a JSON-encoded value which Jest will use as configuration.

--coverage

Indicates that test coverage information should be collected and reported in the output.

--debug

Print debugging info about your jest config.

--env=<environment>

The test environment used for all tests. This can point to any file or node module. Examples: jsdom, node or path/to/my-environment.js.

--expand

Alias: -e. Use this flag to show full diffs instead of a patch.

--findRelatedTests=<listOfSourceFiles>

Find the tests that cover a list of source files that were passed in as arguments. Useful for pre-commit hook integration to run the minimal amount of tests necessary.

--forceExit

Force Jest to exit after all tests have completed running. This is useful when resources set up by test code cannot be adequately cleaned up.

--help

Show some helpful information, similar to this page.

--json

Prints the test results in JSON. This mode will send all other test output and user messages to stderr.

--outputFile=<filename>

Write test results to a file when the --json option is also specified.

--lastCommit

Will run all tests affected by file changes in the last commit made.

--logHeapUsage

Logs the heap usage after every test. Useful to debug memory leaks. Use together with --runInBand and --expose-gc in node.

--maxWorkers=<num>

Alias: -w. Specifies the maximum number of workers the worker-pool will spawn for running tests. This defaults to the number of the cores available on your machine. Overriding this is rarely a good idea.

--noStackTrace

Disables stack trace in test results output.

--notify

Activates notifications for test results. Good for when you don't want your consciousness to be able to focus on anything except JavaScript testing.

--onlyChanged

Alias: -o. Attempts to identify which tests to run based on which files have changed in the current repository. Only works if you're running tests in a git repository at the moment.

--runInBand

Alias: -i. Run all tests serially in the current process, rather than creating a worker pool of child processes that run tests. This is sometimes useful for debugging, but generally discouraged.

--setupTestFrameworkScriptFile=<file>

The path to a module that runs some code to configure or set up the testing framework before each test.

--silent

Prevent tests from printing messages through the console.

--testNamePattern=<regex>

Alias: -t. Run only tests with a name that matches the regex.

--testPathPattern=<regex>

A regexp pattern string that is matched against all tests paths before executing the test.

--testRunner=<path>

Lets you specify a custom test runner.

--updateSnapshot

Alias: -u. Use this flag to re-record every snapshot that fails during this test run. Can be used together with a test suite pattern or with --testNamePattern to re-record snapshots.

--useStderr

Divert all output to stderr.

--verbose

Display individual test results with the test suite hierarchy.

--version

Alias: -v. Print the version and exit.

--watch

Watch files for changes and rerun tests related to changed files. If you want to re-run all tests when a file has changed, use the --watchAll option instead.

--watchAll

Watch files for changes and rerun all tests when something changes. If you want to re-run only the tests that depend on the changed files, use the --watch option.

--watchman

Whether to use watchman for file crawling. Defaults to true. Disable using --no-watchman.