Skip to main content
Version: 29.7

Opțiuni Jest pentru linia de comandă

Comanda jest are mai multe opţiuni utile. Puteţi executa jest --help pentru a vizualiza toate opţiunile disponibile. De asemenea, multe dintre opţiunile de mai jos pot fi folosite împreună, pentru a rula testele exact aşa cum doriţi. Fiecare dintre opţiunile de configurare Jest pot fi specificate, de asemenea, prin intermediul CLI.

Aici este o scurtă prezentare:

Rularea din linia de comandă​

Execută toate testele (implicit):

jest

Execută doar testele care s-au specificat cu un model sau cu un nume de fişier:

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

Execută testele legate de fişierele modificate în hg/git (fişiere pentru care nu s-a facut commit):

jest -o

Execută testele legate de fișierele path/to/fileA.js şi path/to/fileB.js:

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

Execută teste care se potrivesc cu acest nume (caută în textele din blocurile describe sau test).

jest -t name-of-spec

Execută în mod de veghe:

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

Modul de veghe permite să specificaţi numele sau calea către un fișier pentru a vă concentra pe un anumit set de teste.

Using with package manager​

If you run Jest via your package manager, you can still pass the command line arguments directly as Jest arguments.

Instead of:

jest -u -t="ColorPicker"

puteţi scrie:

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

Camelcase & dashed args support​

Jest supports both camelcase and dashed arg formats. The following examples will have an equal result:

jest --collect-coverage
jest --collectCoverage

Arguments can also be mixed:

jest --update-snapshot --detectOpenHandles

Options​

note

CLI options take precedence over values from the Configuration.

Reference​

jest <regexForTestFiles>​

Când executaţi jest cu un argument, el este tratat ca o expresie regulată pentru a căuta fișierele din proiect. Este posibilă rularea testelor prin furnizarea unui tipar. Numai fişierele care se potrivesc tiparului vor fi preluate şi executate. Depending on your terminal, you may need to quote this argument: jest "my.*(complex)?pattern". On Windows, you will need to use / as a path separator or escape \ as \\.

--bail[=<n>]​

Alias: -b. Exit the test suite immediately upon n number of failing test suite. Defaults to 1.

--cache​

Dacă se utilizează memoria cache. Setarea implicită este true. Se poate dezactiva cache-ul folosind --no-cache.

caution

The cache should only be disabled if you are experiencing caching related problems. On average, disabling the cache makes Jest at least two times slower.

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

--changedFilesWithAncestor​

Runs tests related to the current changes and the changes made in the last commit. Behaves similarly to --onlyChanged.

--changedSince​

Runs tests related to the changes since the provided branch or commit hash. If the current branch has diverged from the given branch, then only changes made locally will be tested. Behaves similarly to --onlyChanged.

--ci​

Când această opţiune este folosită, Jest va presupune că se execută într-un mediu de CI. Acest lucru schimbă comportamentul atunci când un nouă imagine instantaneu este întâlnită. În locul comportamentului normal de a stoca automat un nou instantaneu, acesta va eşua testul şi va cere ca Jest să fie executat cu --updateSnapshot.

--clearCache​

Deletes the Jest cache directory and then exits without running tests. Will delete cacheDirectory if the option is passed, or Jest's default cache directory. The default cache directory can be found by calling jest --showConfig.

caution

Clearing the cache will reduce performance.

--clearMocks​

Automatically clear mock calls, instances, contexts and results before every test. Equivalent to calling jest.clearAllMocks() before each test. This does not remove any mock implementation that may have been provided.

--collectCoverageFrom=<glob>​

A glob pattern relative to rootDir matching the files that coverage info needs to be collected from.

--colors​

Forţează afișarea rezultatelor testelor să fie colorate chiar dacă stdout nu este un TTY.

note

Alternatively you can set the environment variable FORCE_COLOR=true to forcefully enable or FORCE_COLOR=false to disable colorized output. The use of FORCE_COLOR overrides all other color support checks.

--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 directory containing the config file is assumed to be the rootDir for the project. Acest lucru poate fi, de asemenea, o valoare codificată JSON pe care Jest o va folosi pe post de configurare.

--coverage[=<boolean>]​

Alias: --collectCoverage. Indică faptul că informaţiile de acoperire a codului vor fi colectate și afișate. Optionally pass <boolean> to override option set in configuration.

--coverageDirectory=<path>​

The directory where Jest should output its coverage files.

--coverageProvider=<provider>​

Indicates which provider should be used to instrument code for coverage. Allowed values are babel (default) or v8.

--debug​

Print debugging info about your Jest config.

--detectOpenHandles​

Attempt to collect and print open handles preventing Jest from exiting cleanly. Use this in cases where you need to use --forceExit in order for Jest to exit to potentially track down the reason. This implies --runInBand, making tests run serially. Implemented using async_hooks. This option has a significant performance penalty and should only be used for debugging.

--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.

--errorOnDeprecated​

Make calling deprecated APIs throw helpful error messages. Useful for easing the upgrade process.

--expand​

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

--filter=<file>​

Path to a module exporting a filtering function. This asynchronous function receives a list of test paths which can be manipulated to exclude tests from running by returning an object with shape { filtered: Array<{ test: string }> }. Especially useful when used in conjunction with a testing infrastructure to filter known broken tests, e.g.

my-filter.js
module.exports = testPaths => {
  const allowedPaths = testPaths
    .filter(filteringFunction)
    .map(test => ({test})); // [{ test: "path1.spec.js" }, { test: "path2.spec.js" }, etc]

  return {
    filtered: allowedPaths,
  };
};

--findRelatedTests <spaceSeparatedListOfSourceFiles>​

Find and run the tests that cover a space separated list of source files that were passed in as arguments. Useful for pre-commit hook integration to run the minimal amount of tests necessary. Can be used together with --coverage to include a test coverage for the source files, no duplicate --collectCoverageFrom arguments needed.

--forceExit​

Forţează ieșirea din Jest după ce toate testele și-au finalizat rularea. Acest lucru este util atunci când resursele setate din codul de test nu pot fi curăţate în mod adecvat.

caution

This feature is an escape-hatch. Dacă Jest nu returnează la sfârşitul rulării unui test, înseamnă că resurse externe sunt încă în execuție sau cronometrele sunt încă în aşteptare în codul rulat. Este recomandat să curățați resursele externe, după fiecare test pentru a vă asigura că Jest își poate încheia rularea în mod curat. You can use --detectOpenHandles to help track it down.

--help​

Afișează informaţii ajutătoare, similar cu această pagină.

--ignoreProjects <project1> ... <projectN>​

Ignore the tests of the specified projects. Jest uses the attribute displayName in the configuration to identify each project. If you use this option, you should provide a displayName to all your projects.

--init​

Generate a basic configuration file. Based on your project, Jest will ask you a few questions that will help to generate a jest.config.js file with a short description for each option.

--injectGlobals​

Insert Jest's globals (expect, test, describe, beforeEach etc.) into the global environment. If you set this to false, you should import from @jest/globals, e.g.

import {expect, jest, test} from '@jest/globals';

jest.useFakeTimers();

test('some test', () => {
  expect(Date.now()).toBe(0);
});
note

This option is only supported using the default jest-circus test runner.

--json​

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

--lastCommit​

Run all tests affected by file changes in the last commit made. Behaves similarly to --onlyChanged.

--listTests​

Lists all test files that Jest will run given the arguments, and exits.

--logHeapUsage​

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

--maxConcurrency=<num>​

Prevents Jest from executing more than the specified amount of tests at the same time. Only affects tests that use test.concurrent.

--maxWorkers=<num>|<string>​

Alias: -w. Specifică numărul maxim de workeri ce vor fi instanțiați pentru teste. In single run mode, this defaults to the number of the cores available on your machine minus one for the main thread. In watch mode, this defaults to half of the available cores on your machine to ensure Jest is unobtrusive and does not grind your machine to a halt. It may be useful to adjust this in resource limited environments like CIs but the defaults should be adequate for most use-cases.

For environments with variable CPUs available, you can use percentage based configuration: --maxWorkers=50%

--noStackTrace​

Dezactivează urmărirea stivei de execuție în afișarea rezultatelor testelor.

--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. Încearcă să identifice care teste trebuie rulate pe baza fişierelor care s-au modificat în proiectul curent. Only works if you're running tests in a git/hg repository at the moment and requires a static dependency graph (ie. no dynamic requires).

--onlyFailures​

Alias: -f. Run tests that failed in the previous execution.

--openHandlesTimeout=<milliseconds>​

When --detectOpenHandles and --forceExit are disabled, Jest will print a warning if the process has not exited cleanly after this number of milliseconds. A value of 0 disables the warning. Defaults to 1000.

--outputFile=<filename>​

Scrie rezultatele testelor într-un fișier atunci când este specificată și opţiunea --json. The returned JSON structure is documented in testResultsProcessor.

--passWithNoTests​

Allows the test suite to pass when no files are found.

--projects <path1> ... <pathN>​

Run tests from one or more projects, found in the specified paths; also takes path globs. This option is the CLI equivalent of the projects configuration option.

note

If configuration files are found in the specified paths, all projects specified within those configuration files will be run.

--randomize​

Shuffle the order of the tests within a file. The shuffling is based on the seed. See --seed=<num> for more info.

Seed value is displayed when this option is set. Equivalent to setting the CLI option --showSeed.

jest --randomize --seed 1234
note

This option is only supported using the default jest-circus test runner.

--reporters​

Run tests with specified reporters. Reporter options are not available via CLI. Example with multiple reporters:

jest --reporters="default" --reporters="jest-junit"

--resetMocks​

Automatically reset mock state before every test. Equivalent to calling jest.resetAllMocks() before each test. This will lead to any mocks having their fake implementations removed but does not restore their initial implementation.

--restoreMocks​

Automatically restore mock state and implementation before every test. Equivalent to calling jest.restoreAllMocks() before each test. This will lead to any mocks having their fake implementations removed and restores their initial implementation.

--roots​

A list of paths to directories that Jest should use to search for files in.

--runInBand​

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

--runTestsByPath​

Run only the tests that were specified with their exact paths. This avoids converting them into a regular expression and matching it against every single file.

For example, given the following file structure:

__tests__
└── t1.test.js # test
└── t2.test.js # test

When ran with a pattern, no test is found:

jest --runTestsByPath __tests__/t

Output:

No tests found

However, passing an exact path will execute only the given test:

jest --runTestsByPath __tests__/t1.test.js

Output:

PASS __tests__/t1.test.js
tip

The default regex matching works fine on small runs, but becomes slow if provided with multiple patterns and/or against a lot of tests. This option replaces the regex matching logic and by that optimizes the time it takes Jest to filter specific test files.

--seed=<num>​

Sets a seed value that can be retrieved in a test file via jest.getSeed(). The seed value must be between -0x80000000 and 0x7fffffff inclusive (-2147483648 (-(2 ** 31)) and 2147483647 (2 ** 31 - 1) in decimal).

jest --seed=1324
tip

If this option is not specified Jest will randomly generate the value. You can use the --showSeed flag to print the seed in the test report summary.

Jest uses the seed internally for shuffling the order in which test suites are run. If the --randomize option is used, the seed is also used for shuffling the order of tests within each describe block. When dealing with flaky tests, rerunning with the same seed might help reproduce the failure.

--selectProjects <project1> ... <projectN>​

Run the tests of the specified projects. Jest uses the attribute displayName in the configuration to identify each project. If you use this option, you should provide a displayName to all your projects.

--setupFilesAfterEnv <path1> ... <pathN>​

A list of paths to modules that run some code to configure or to set up the testing framework before each test. Beware that files imported by the setup scripts will not be mocked during testing.

--shard​

The test suite shard to execute in a format of (?<shardIndex>\d+)/(?<shardCount>\d+).

shardIndex describes which shard to select while shardCount controls the number of shards the suite should be split into.

shardIndex and shardCount have to be 1-based, positive numbers, and shardIndex has to be lower than or equal to shardCount.

When shard is specified the configured testSequencer has to implement a shard method.

For example, to split the suite into three shards, each running one third of the tests:

jest --shard=1/3
jest --shard=2/3
jest --shard=3/3

--showConfig​

Împiedică afișarea mesajelor prin consolă.

--showSeed​

Prints the seed value in the test report summary. See --seed=<num> for the details.

Can also be set in configuration. See showSeed.

--silent​

Împiedică afișarea mesajelor prin consolă.

--testEnvironmentOptions=<json string>​

A JSON string with options that will be passed to the testEnvironment. The relevant options depend on the environment.

--testLocationInResults​

Adds a location field to test results. Useful if you want to report the location of a test in a reporter.

note

In the resulting object column is 0-indexed while line is not.

{
  "column": 4,
  "line": 5
}

--testMatch glob1 ... globN​

The glob patterns Jest uses to detect test files. Please refer to the testMatch configuration for details.

--testNamePattern=<regex>​

Alias: -t. Run only tests with a name that matches the regex. For example, suppose you want to run only tests related to authorization which will have names like 'GET /api/posts with auth', then you can use jest -t=auth.

tip

The regex is matched against the full name, which is a combination of the test name and all its surrounding describe blocks.

--testPathIgnorePatterns=<regex>|[array]​

A single or array of regexp pattern strings that are tested against all tests paths before executing the test. Contrary to --testPathPattern, it will only run those tests with a path that does not match with the provided regexp expressions.

To pass as an array use escaped parentheses and space delimited regexps such as \(/node_modules/ /tests/e2e/\). Alternatively, you can omit parentheses by combining regexps into a single regexp like /node_modules/|/tests/e2e/. These two examples are equivalent.

--testPathPattern=<regex>​

Execută doar testele al din fișierele al caror cale se potriveşte cu expresia regulată specificată. On Windows, you will need to use / as a path separator or escape \ as \\.

--testRunner=<path>​

Vă permite să specificaţi un framework de testare personalizat.

--testSequencer=<path>​

Lets you specify a custom test sequencer. Please refer to the testSequencer configuration for details.

--testTimeout=<number>​

Default timeout of a test in milliseconds. Default value: 5000.

--updateSnapshot​

Alias: -u. Folosiţi această opțiune pentru re-înregistrarea fiecărei imagini instantaneu care eșuează în timpul rulării. Poate fi utilizat împreună cu un tipar de suite de teste sau cu --testNamePattern.

--useStderr​

Afişează rezultatele testelor individuale cu ierarhia suitei de teste.

--verbose​

Afişează rezultatele testelor individuale cu ierarhia suitei de teste.

--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.

tip

Use --no-watch (or --watch=false) to explicitly disable the watch mode if it was enabled using --watch. In most CI environments, this is automatically handled for you.

--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.

tip

Use --no-watchAll (or --watchAll=false) to explicitly disable the watch mode if it was enabled using --watchAll. In most CI environments, this is automatically handled for you.

--watchman​

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

--workerThreads​

Whether to use worker threads for parallelization. Child processes are used by default.

caution

This is experimental feature. See the workerThreads configuration option for more details.