Configuring Jest

Jest's configuration can be defined in the package.json file of your project, through a jest.config.js file or through the --config <path/to/js|json> option. Якщо ви хочете використовувати ваш package.json для збереження конфігурації Jest, ключ "jest" повинен знаходитися на верхньому рівні файлу, щоб Jest знав як знайти ваші налаштування:

{
  "name": "my-project",
  "jest": {
    "verbose": true
  }
}

Або використовуючи JavaScript:

// jest.config.js
module.exports = {
  verbose: true,
};

Майте на увазі, що фінальна конфігурація повинна бути придатна для серіалізації в JSON.

Якщо ви використовуєте --config опцію, JSON файл не повинен містити ключа "jest":

{
  "bail": true,
  "verbose": true
}

Опції #

Нижчевказані опції, вказані в файлі package.json дозволяють вам керувати поведінкою Jest. Філософія Jest - прекрасно працювати за замовчуванням, але інколи може знадобитися більше можливостей для конфігурації.

Довідка #

`automock` [boolean] #

За замовчуванням: false

Цей параметр вимкнуто за замовчуванням. Якщо ви запроваджуєте використання Jest у великій організації з існуючою кодовою базою, але з невеликою кількістю тестів, увімкнення цієї опції може бути корисним для поступового додавання юніт тестів. Для модулів може явно застосовуватися автоматичне створення імітацій використовуючи jest.mock(moduleName).

Примітка: до модулів ядра таких, як fs, створення імітацій за замовчуванням не застосовується. Це можна зробити явно наступним чином: jest.mock('fs').

Примітка: автоматичне створення імітацій може впливати на швидкодію, що особливо відчутно у великих проектах. Ознайомтеся з цією статтею для отримання деталей і обхідних шляхів.

`browser` [boolean] #

За замовчуванням: false

Чи враховувати поле Browserify "browser" в package.json під час пошуку модулів. Деякі модулі експортують різні версії в залежності від того, чи вони виконуються в Node, чи в браузері.

`bail` [boolean] #

За замовчуванням: false

За замовчуванням, Jest виконує всі тести та виводить всі помилки в консоль по завершенню. Опція bail може бути використана щоб Jest зупинив виконання тестів після першої помилки.

`cacheDirectory` [string] #

За замовчуванням: "/tmp/ < шлях >"

Каталог в якому Jest має зберігати свою кешовану інформацію про залежності.

Jest сканує ваше дерево залежностей один раз (наперед) і кешує його аби дещо полегшити згрібання файлової системи, що відбувається при виконанні тестів. Ця опція дозволяє налаштувати де саме Jest зберігатиме цю кешовану інформацію на диску.

`collectCoverage` [boolean] #

За замовчуванням: false

Визначає чи потрібно збирати інформацію про покриття під час виконання тестів. Оскільки це модифікує всі виконані файли інструкціями збирання покриття, це може суттєво сповільнити тести.

`collectCoverageFrom` [array] #

За замовчуванням: undefined

Масив шаблонів що визначає набір файлів для яких має бути зібрана інформація про покриття. Якщо файл підходить під один з шаблонів інформація про покриття буде зібрана для нього навіть якщо для цього файлу не існує тестів і він не використовується в наборі тестів.

Приклад:

{
  "collectCoverageFrom" : ["**/*.{js,jsx}", "!**/node_modules/**", "!**/vendor/**"]
}

Це збере інформацію про покриття для всіх файлів в каталозі rootDir, окрім тих що збігаються з **/node_modules/** чи **/vendor/**.

Примітка: Цей параметр вимагає collectCoverage бути рівним true або щоб Jest, було викликано з --coverage.

`coverageDirectory` [string] #

За замовчуванням: undefined

Каталог, де Jest виводить файли покриття.

`coveragePathIgnorePatterns` [array<string>] #

За замовчуванням: ["/node_modules/"]

Масив рядків регулярних виразі, що зіставляються з усіма файловими шляхами перед виконанням тестів. Якщо файловий шлях збігається з будь яким виразом, інформацію про покриття буде пропущено.

Ці рядкові вирази зіставляються з повним шляхом. Використовуйте рядковий токен <rootDir> аби додати шлях до кореневого каталогу проекту щоб запобігти випадковому ігноруванню всіх ваших файлів в інших середовищах, що мають відмінні кореневі каталоги. Приклад: ["<rootDir>/build/", "<rootDir>/node_modules/"].

`coverageReporters` [array<string>] #

За замовчуванням: ["json", "lcov", "text"]

A list of reporter names that Jest uses when writing coverage reports. Any istanbul reporter can be used.

Note: Setting this option overwrites the default values. Add "text" or "text-summary" to see a coverage summary in the console output.

`coverageThreshold` [object] #

За замовчуванням: undefined

This will be used to configure minimum threshold enforcement for coverage results. If the thresholds are not met, jest will return failure. Thresholds, when specified as a positive number are taken to be the minimum percentage required. When a threshold is specified as a negative number it represents the maximum number of uncovered entities allowed.

For example, statements: 90 implies minimum statement coverage is 90%. statements: -10 implies that no more than 10 uncovered statements are allowed.

{
  ...
  "jest": {
    "coverageThreshold": {
      "global": {
        "branches": 50,
        "functions": 50,
        "lines": 50,
        "statements": 50
      }
    }
  }
}

`globals` [object] #

За замовчуванням: {}

Множина глобальних змінних, що повинна бути доступною у всіх тестових середовищах.

Наприклад, наступний код присвоїть глобальній змінній __DEV__ значення true у всіх тестових середовищах:

{
  ...
  "jest": {
    "globals": {
      "__DEV__": true
    }
  }
}

Note that, if you specify a global reference value (like an object or array) here, and some code mutates that value in the midst of running a test, that mutation will not be persisted across test runs for other test files.

`mapCoverage` [boolean] #

Доступно в Jest 20.0.0+ #

За замовчуванням: false

If you have transformers configured that emit source maps, Jest will use them to try and map code coverage against the original source code when writing reports and checking thresholds. This is done on a best-effort basis as some compile-to-JavaScript languages may provide more accurate source maps than others. This can also be resource-intensive. If Jest is taking a long time to calculate coverage at the end of a test run, try setting this option to false.

Both inline source maps and source maps returned directly from a transformer are supported. Source map URLs are not supported because Jest may not be able to locate them. To return source maps from a transformer, the process function can return an object like the following. The map property may either be the source map object, or the source map object as a JSON string.

return {
  code: 'the code',
  map: 'the source map',
};

`moduleFileExtensions` [array<string>] #

За замовчуванням: ["js", "json", "jsx", "вузол"]

An array of file extensions your modules use. If you require modules without specifying a file extension, these are the extensions Jest will look for.

Якщо ви використовуєте TypeScript це повинно бути ["js", "jsx", "json", "ts", "tsx"]

`moduleDirectories` [array<string>] #

За замовчуванням: ["node_modules"]

An array of directory names to be searched recursively up from the requiring module's location. Setting this option will override the default, if you wish to still search node_modules for packages include it along with any other options: ["node_modules", "bower_components"]

`moduleNameMapper` [object<string, string>] #

За замовчуванням: null

A map from regular expressions to module names that allow to stub out resources, like images or styles with a single module.

Modules that are mapped to an alias are unmocked by default, regardless of whether automocking is enabled or not.

Use <rootDir> string token to refer to rootDir value if you want to use file paths.

Additionally, you can substitute captured regex groups using numbered backreferences.

Приклад:

{
  "moduleNameMapper": {
    "^image![a-zA-Z0-9$_-]+$": "GlobalImageStub",
    "^[./a-zA-Z0-9$_-]+\.png$": "<rootDir>/RelativeImageStub.js",
    "module_name_(.*)": "<rootDir>/substituted_module_$1.js"
  }
}

Note: If you provide module name without boundaries ^$ it may cause hard to spot errors. E.g. relay will replace all modules which contain relay as a substring in its name: relay, react-relay and graphql-relay will all be pointed to your stub.

`modulePathIgnorePatterns` [array<string>] #

За замовчуванням: []

An array of regexp pattern strings that are matched against all module paths before those paths are to be considered 'visible' to the module loader. If a given module's path matches any of the patterns, it will not be require()-able in the test environment.

`modulePaths` [array<string>] #

За замовчуванням: []

An alternative API to setting the NODE_PATH env variable, modulePaths is an array of absolute paths to additional locations to search when resolving modules. Use the <rootDir> string token to include the path to your project's root directory. Example: ["<rootDir>/app/"].

`notify` [boolean] #

За замовчуванням: false

Активує сповіщення про результати тестування.

`preset` [string] #

За замовчуванням: undefined

A preset that is used as a base for Jest's configuration. A preset should point to an npm module that exports a jest-preset.json module on its top level.

`projects` [array<string>] #

За замовчуванням: undefined

When the projects configuration is provided with an array of paths or glob patterns, Jest will run tests in all of the specified projects at the same time. This is great for monorepos or when working on multiple projects at the same time.

{
  "projects": [
    "<rootDir>",
    "<rootDir>/examples/*"
  ]
}

This example configuration will run Jest in the root directory as well as in every folder in the examples directory. You can have an unlimited amount of projects running in the same Jest instance.

`clearMocks` [boolean] #

За замовчуванням: false

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

`reporters` [array<modulename | [modulename, options]>] #

За замовчуванням: undefined

Доступно в Jest 20.0.0+ #

Use this configuration option to add custom reporters to Jest. A custom reporter is a class that implements onRunStart, onTestStart, onTestResult, onRunComplete methods that will be called when any of those events occurs.

If custom reporters are specified, the default Jest reporters will be overridden. To keep default reporters, default can be passed as a module name.

This will override default reporters:

{
  "reporters": [
    "<rootDir>/my-custom-reporter.js"
  ]
}

This will use custom reporter in addition to default reporters that Jest provides:

{
  "reporters": [
    "default",
    "<rootDir>/my-custom-reporter.js"
  ]
}

Additionally, custom reporters can be configured by passing an options object as a second argument:

{
  "reporters": [
    "default",
    ["<rootDir>/my-custom-reporter.js", {"banana": "yes", "pineapple": "no"}]
  ]
}

Custom reporter modules must define a class that takes a GlobalConfig and reporter options as constructor arguments:

Example reporter:

// my-custom-reporter.js
class MyCustomReporter {
  constructor(globalConfig, options) {
    this._globalConfig = globalConfig;
    this._options = options;
  }

  onRunComplete(contexts, results) {
    console.log('Custom reporter output:');
    console.log('GlobalConfig: ', this._globalConfig);
    console.log('Options: ', this._options);
  }
}

module.exports = MyCustomReporter;

Custom reporters can also force Jest to exit with non-0 code by returning an Error from getLastError() methods

class MyCustomReporter {
  // ...
  getLastError() {
    if (this._shouldFail) {
      return new Error('my-custom-reporter.js reported an error');
    }
  }
}

For the full list of methods and argument types see Reporter type in types/TestRunner.js

`resetMocks` [boolean] #

За замовчуванням: false

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

`resetModules` [boolean] #

За замовчуванням: false

If enabled, the module registry for every test file will be reset before running each individual test. This is useful to isolate modules for every test so that local module state doesn't conflict between tests. This can be done programmatically using jest.resetModules().

`resolver` [string] #

За замовчуванням: undefined

Доступно в Jest 20.0.0+ #

This option allows the use of a custom resolver. This resolver must be a node module that exports a function expecting a string as the first argument for the path to resolve and an object with the following structure as the second argument:

{
  "basedir": string,
  "browser": bool,
  "extensions": [string],
  "moduleDirectory": [string],
  "paths": [string]
}

The function should either return a path to the module that should be resolved or throw an error if the module can't be found.

`rootDir` [string] #

Default: The root of the directory containing the package.json or the pwd if no package.json is found

The root directory that Jest should scan for tests and modules within. If you put your Jest config inside your package.json and want the root directory to be the root of your repo, the value for this config param will default to the directory of the package.json.

Oftentimes, you'll want to set this to 'src' or 'lib', corresponding to where in your repository the code is stored.

Note that using '<rootDir>' as a string token in any other path-based config settings will refer back to this value. So, for example, if you want your setupFiles config entry to point at the env-setup.js file at the root of your project, you could set its value to ["<rootDir>/env-setup.js"].

`roots` [array<string>] #

За замовчуванням: ["< rootDir >"]

Список шляхів до директорій, що Jest повинен використовувати для пошуку файлів в них.

There are times where you only want Jest to search in a single sub-directory (such as cases where you have a src/ directory in your repo), but prevent it from accessing the rest of the repo.

Note: While rootDir is mostly used as a token to be re-used in other configuration options, roots is used by the internals of Jest to locate test files and source files. By default, roots has a single entry <rootDir> but there are cases where you want to have multiple roots within one project, for example roots: ["<rootDir>/src/", "<rootDir>/tests/"].

`setupFiles` [array] #

За замовчуванням: []

The paths to modules that run some code to configure or set up the testing environment before each test. Since every test runs in its own environment, these scripts will be executed in the testing environment immediately before executing the test code itself.

It's worth noting that this code will execute before setupTestFrameworkScriptFile.

`setupTestFrameworkScriptFile` [string] #

За замовчуванням: undefined

The path to a module that runs some code to configure or set up the testing framework before each test. Since setupFiles executes before the test framework is installed in the environment, this script file presents you the opportunity of running some code immediately after the test framework has been installed in the environment.

For example, Jest ships with several plug-ins to jasmine that work by monkey-patching the jasmine API. If you wanted to add even more jasmine plugins to the mix (or if you wanted some custom, project-wide matchers for example), you could do so in this module.

`snapshotSerializers` [array<string>] #

За замовчуванням: []

A list of paths to snapshot serializer modules Jest should use for snapshot testing.

Jest has default serializers for built-in JavaScript types, HTML elements (Jest 20.0.0+), ImmutableJS (Jest 20.0.0+) and for React elements. See snapshot test tutorial for more information.

Example serializer module:

// my-serializer-module
module.exports = {
  print(val, serialize, indent) {
    return 'Pretty foo: ' + serialize(val.foo);
  },

  test(val) {
    return val && val.hasOwnProperty('foo');
  },

};

serialize - це функція, що серіалізує значення використовуючи наявні плагіни.

Для того, щоб використовувати my-serializer-module як серіалізатор, конфігурація повинна бути наступною:

{
  ...
  "jest": {
    "snapshotSerializers": ["my-serializer-module"]
  }
}

Нарешті тести будуть виглядати наступним чином:

test(() => {
  const bar = {
    foo: {
      x: 1,
      y: 2,
    },
  };

  expect(bar).toMatchSnapshot();
});

Rendered snapshot:

Pretty foo: Object {
  "x": 1,
  "y": 2,
}

To make a dependency explicit instead of implicit, you can call expect.addSnapshotSerializer to add a module for an individual test file instead of adding its path to snapshotSerializers in Jest configuration.

`testEnvironment` [string] #

За замовчуванням: "jsdom"

The test environment that will be used for testing. The default environment in Jest is a browser-like environment through jsdom. If you are building a node service, you can use the node option to use a node-like environment instead.

If some tests require another environment, you can add a @jest-environment docblock.

Доступно в Jest 20.0.0+ #

/**
 * @jest-environment jsdom
 */

test('use jsdom in this test file', () => {
  const element = document.createElement('div');
  expect(element).not.toBeNull();
});

You can create your own module that will be used for setting up the test environment. The module must export a class with runScript and dispose methods. See the node or jsdom environments as examples.

`testMatch` [array<string>] #

доступно в Jest 19.0.0+ #

(за замовчуванням: [ '**/__tests__/**/*.js?(x)', '**/?(*.)(spec|test).js?(x)' ])

The glob patterns Jest uses to detect test files. By default it looks for .js and .jsx files inside of __tests__ folders, as well as any files with a suffix of .test or .spec (e.g. Component.test.js or Component.spec.js). It will also find files called test.js or spec.js.

See the micromatch package for details of the patterns you can specify.

See also testRegex [string], but note that you cannot specify both options.

`testPathIgnorePatterns` [array<string>] #

За замовчуванням: ["/node_modules/"]

An array of regexp pattern strings that are matched against all test paths before executing the test. If the test path matches any of the patterns, it will be skipped.

`testRegex` [string] #

За замовчуванням: (/__tests__/.*| ( \\.| /) (test|spec))\\.jsx?$

The pattern Jest uses to detect test files. By default it looks for .js and .jsx files inside of __tests__ folders, as well as any files with a suffix of .test or .spec (e.g. Component.test.js or Component.spec.js). It will also find files called test.js or spec.js. See also testMatch [array<string>], but note that you cannot specify both options.

The following is a visualization of the default regex:

├── __tests__
│   └── component.spec.js # test
│   └── anything # test
├── package.json # not test
├── foo.test.js # test
├── bar.spec.jsx # test
└── component.js # not test

`testResultsProcessor` [string] #

За замовчуванням: undefined

This option allows the use of a custom results processor. This processor must be a node module that exports a function expecting an object with the following structure as the first argument:

{
  "success": bool,
  "startTime": epoch,
  "numTotalTestSuites": number,
  "numPassedTestSuites": number,
  "numFailedTestSuites": number,
  "numRuntimeErrorTestSuites": number,
  "numTotalTests": number,
  "numPassedTests": number,
  "numFailedTests": number,
  "numPendingTests": number,
  "testResults": [{
    "numFailingTests": number,
    "numPassingTests": number,
    "numPendingTests": number,
    "testResults": [{
      "title": string (message in it block),
      "status": "failed" | "pending" | "passed",
      "ancestorTitles": [string (message in describe blocks)],
      "failureMessages": [string],
      "numPassingAsserts": number
    },
    ...
    ],
    "perfStats": {
      "start": epoch,
      "end": epoch
    },
    "testFilePath": absolute path to test file,
    "coverage": {}
  },
  ...
  ]
}

`testRunner` [string] #

За замовчуванням: jasmine2

This option allows use of a custom test runner. The default is jasmine2. A custom test runner can be provided by specifying a path to a test runner implementation.

The test runner module must export a function with the following signature:

function testRunner(
  config: Config,
  environment: Environment,
  runtime: Runtime,
  testPath: string,
): Promise<TestResult>

An example of such function can be found in our default jasmine2 test runner package.

`testURL` [string] #

За замовчуванням: about:blank

This option sets the URL for the jsdom environment. It is reflected in properties such as location.href.

`timers` [string] #

За замовчуванням: real

Setting this value to fake allows the use of fake timers for functions such as setTimeout. Fake timers are useful when a piece of code sets a long timeout that we don't want to wait for in a test.

`transform` [object<string, string>] #

За замовчуванням: undefined

A map from regular expressions to paths to transformers. A transformer is a module that provides a synchronous function for transforming source files. For example, if you wanted to be able to use a new language feature in your modules or tests that isn't yet supported by node, you might plug in one of many compilers that compile a future version of JavaScript to a current one. Example: see the examples/typescript example or the webpack tutorial.

Examples of such compilers include babel, typescript, and async-to-gen.

Note: a transformer is only ran once per file unless the file has changed. During development of a transformer it can be useful to run Jest with --no-cache or to frequently delete Jest's cache.

Note: if you are using the babel-jest transformer and want to use an additional code preprocessor, keep in mind that when "transform" is overwritten in any way the babel-jest is not loaded automatically anymore. If you want to use it to compile JavaScript code it has to be explicitly defined. See babel-jest plugin

`transformIgnorePatterns` [array<string>] #

За замовчуванням: ["/node_modules/"]

An array of regexp pattern strings that are matched against all source file paths before transformation. If the test path matches any of the patterns, it will not be transformed.

Ці рядкові вирази зіставляються з повним шляхом. Використовуйте рядковий токен <rootDir> аби додати шлях до кореневого каталогу проекту щоб запобігти випадковому ігноруванню всіх ваших файлів в інших середовищах, що мають відмінні кореневі каталоги. Example: ["<rootDir>/bower_components/", "<rootDir>/node_modules/"].

`unmockedModulePathPatterns` [array<string>] #

За замовчуванням: []

An array of regexp pattern strings that are matched against all modules before the module loader will automatically return a mock for them. If a module's path matches any of the patterns in this list, it will not be automatically mocked by the module loader.

This is useful for some commonly used 'utility' modules that are almost always used as implementation details almost all the time (like underscore/lo-dash, etc). It's generally a best practice to keep this list as small as possible and always use explicit jest.mock()/jest.unmock() calls in individual tests. Explicit per-test setup is far easier for other readers of the test to reason about the environment the test will run in.

It is possible to override this setting in individual tests by explicitly calling jest.mock() at the top of the test file.

`verbose` [boolean] #

За замовчуванням: false

Indicates whether each individual test should be reported during the run. All errors will also still be shown on the bottom after execution.

Опції #

Довідка #

automock [boolean] #

browser [boolean] #

bail [boolean] #

cacheDirectory [string] #

collectCoverage [boolean] #

collectCoverageFrom [array] #

coverageDirectory [string] #

coveragePathIgnorePatterns [array<string>] #

coverageReporters [array<string>] #

coverageThreshold [object] #

globals [object] #

mapCoverage [boolean] #

Доступно в Jest 20.0.0+ #

moduleFileExtensions [array<string>] #

moduleDirectories [array<string>] #

moduleNameMapper [object<string, string>] #

modulePathIgnorePatterns [array<string>] #

modulePaths [array<string>] #

notify [boolean] #

preset [string] #

projects [array<string>] #

clearMocks [boolean] #

reporters [array<modulename | [modulename, options]>] #

Доступно в Jest 20.0.0+ #

resetMocks [boolean] #

resetModules [boolean] #

resolver [string] #

Доступно в Jest 20.0.0+ #

rootDir [string] #

roots [array<string>] #

setupFiles [array] #

setupTestFrameworkScriptFile [string] #

snapshotSerializers [array<string>] #

testEnvironment [string] #

Доступно в Jest 20.0.0+ #

testMatch [array<string>] #

доступно в Jest 19.0.0+ #

testPathIgnorePatterns [array<string>] #

testRegex [string] #

testResultsProcessor [string] #

testRunner [string] #

testURL [string] #

timers [string] #

transform [object<string, string>] #

transformIgnorePatterns [array<string>] #

unmockedModulePathPatterns [array<string>] #

verbose [boolean] #

`automock` [boolean] #

`browser` [boolean] #

`bail` [boolean] #

`cacheDirectory` [string] #

`collectCoverage` [boolean] #

`collectCoverageFrom` [array] #

`coverageDirectory` [string] #

`coveragePathIgnorePatterns` [array<string>] #

`coverageReporters` [array<string>] #

`coverageThreshold` [object] #

`globals` [object] #

`mapCoverage` [boolean] #

`moduleFileExtensions` [array<string>] #

`moduleDirectories` [array<string>] #

`moduleNameMapper` [object<string, string>] #

`modulePathIgnorePatterns` [array<string>] #

`modulePaths` [array<string>] #

`notify` [boolean] #

`preset` [string] #

`projects` [array<string>] #

`clearMocks` [boolean] #

`reporters` [array<modulename | [modulename, options]>] #

`resetMocks` [boolean] #

`resetModules` [boolean] #

`resolver` [string] #

`rootDir` [string] #

`roots` [array<string>] #

`setupFiles` [array] #

`setupTestFrameworkScriptFile` [string] #

`snapshotSerializers` [array<string>] #

`testEnvironment` [string] #

`testMatch` [array<string>] #

`testPathIgnorePatterns` [array<string>] #

`testRegex` [string] #

`testResultsProcessor` [string] #

`testRunner` [string] #

`testURL` [string] #

`timers` [string] #

`transform` [object<string, string>] #

`transformIgnorePatterns` [array<string>] #

`unmockedModulePathPatterns` [array<string>] #

`verbose` [boolean] #