Configuring Jest
Jest's configuration can be defined in the package.json file of your project, or through a jest.config.js file or through the --config <path/to/file.js|cjs|mjs|json> option. If you'd like to use your package.json to store Jest's config, the "jest" key should be used on the top level so Jest will know how to find your settings:
{
"name": "my-project",
"jest": {
"verbose": true
}
}
或者通过 JavaScript：
// jest.config.js
module.exports = {
verbose: true,
};
请记住最后拿到的配置必须是可被 JSON 序列化的。
使用--config配置选项时，JSON 文件绝不能有"jest"键值︰
{
"bail": 1,
"verbose": true
}
选项
These options let you control Jest's behavior in your package.json file. The Jest philosophy is to work great by default, but sometimes you just need more configuration power.
Defaults
您可以了解 Jest 的默认选项，以便在必要时扩展它们：
// jest.config.js
const {defaults} = require('jest-config');
module.exports = {
// ...
moduleFileExtensions: [...defaults.moduleFileExtensions, 'ts', 'tsx'],
// ...
};
- 参考
automock[boolean]默认值︰
falseThis option tells Jest that all imported modules in your tests should be mocked automatically. All modules used in your tests will have a replacement implementation, keeping the API surface.
示例：
// utils.js export default { authorize: () => { return 'token'; }, isAuthorized: secret => secret === 'wizard', };//__tests__/automocking.test.js import utils from '../utils'; test('if utils mocked automatically', () => { // Public methods of `utils` are now mock functions expect(utils.authorize.mock).toBeTruthy(); expect(utils.isAuthorized.mock).toBeTruthy(); // You can provide them with your own implementation // or pass the expected return value utils.authorize.mockReturnValue('mocked_token'); utils.isAuthorized.mockReturnValue(true); expect(utils.authorize()).toBe('mocked_token'); expect(utils.isAuthorized('not_wizard')).toBeTruthy(); });Note: Node modules are automatically mocked when you have a manual mock in place (e.g.:
__mocks__/lodash.js). More info here.Note: Core modules, like
fs, are not mocked by default. They can be mocked explicitly, likejest.mock('fs').bail[number | boolean]Default:
0By default, Jest runs all tests and produces all errors into the console upon completion. The bail config option can be used here to have Jest stop running tests after
nfailures. Setting bail totrueis the same as setting bail to1.browser[boolean]默认值︰
false当解析模块时，是否遵循在
package.json中的 Browserify 的"browser"字段。 有些模块会导出不一样的版本，这取决于你是在 Node 还是在一个浏览器中进行操作。cacheDirectory[string]默认值︰
"/tmp/<path>"Jest用来储存依赖信息缓存的目录。
Jest 尝试去扫描你的依赖树一次（前期）并且把依赖树缓存起来，其目的就是抹去某些在运行测试时需要进行的文件系统排序。 这一配置选项让你可以自定义Jest将缓存数据储存在磁盘的那个位置。
clearMocks[boolean]默认值︰
falseAutomatically clear mock calls and instances before every test. Equivalent to calling
jest.clearAllMocks()before each test. This does not remove any mock implementation that may have been provided.collectCoverage[boolean]默认值︰
false指出是否收集测试时的覆盖率信息。 由于要带上覆盖率搜集语句重新访问所有执行过的文件，这可能会让你的测试执行速度被明显减慢。
collectCoverageFrom[array]默认值：
undefinedAn array of glob patterns indicating a set of files for which coverage information should be collected. If a file matches the specified glob pattern, coverage information will be collected for it even if no tests exist for this file and it's never required in the test suite.
示例：
{ "collectCoverageFrom": [ "**/*.{js,jsx}", "!**/node_modules/**", "!**/vendor/**" ] }This will collect coverage information for all the files inside the project's
rootDir, except the ones that match**/node_modules/**or**/vendor/**.注意：该选项要求
collectCoverage被设成true，或者通过--coverage参数来调用 Jest。Help:
If you are seeing coverage output such as...=============================== Coverage summary =============================== Statements : Unknown% ( 0/0 ) Branches : Unknown% ( 0/0 ) Functions : Unknown% ( 0/0 ) Lines : Unknown% ( 0/0 ) ================================================================================ Jest: Coverage data for global was not found.Most likely your glob patterns are not matching any files. Refer to the micromatch documentation to ensure your globs are compatible.
coverageDirectory[string]默认值：
undefinedJest输出覆盖信息文件的目录。
coveragePathIgnorePatterns[array<string>]默认值︰
["node_modules"]An array of regexp pattern strings that are matched against all file paths before executing the test. If the file path matches any of the patterns, coverage information will be skipped.
These pattern strings match against the full path. Use the
<rootDir>string token to include the path to your project's root directory to prevent it from accidentally ignoring all of your files in different environments that may have different root directories. Example:["<rootDir>/build/", "<rootDir>/node_modules/"].coverageProvider[string]Indicates which provider should be used to instrument code for coverage. Allowed values are
babel(default) orv8.Note that using
v8is considered experimental. This uses V8's builtin code coverage rather than one based on Babel and comes with a few caveats- Your node version must include
vm.compileFunction, which was introduced in node 10.10 - Tests needs to run in Node test environment (support for
jsdomrequiresjest-environment-jsdom-sixteen) - V8 has way better data in the later versions, so using the latest versions of node (v13 at the time of this writing) will yield better results
coverageReporters[array<string | [string,any]>]Default:
["json", "lcov", "text", "clover"]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.Note: You can pass additional options to the istanbul reporter using the tuple form. 例如：
["json", ["lcov", {"projectRoot": "../../"}]]coverageThreshold[object]默认值：
undefinedThis will be used to configure minimum threshold enforcement for coverage results. Thresholds can be specified as
global, as a glob, and as a directory or file path. 如果没有达到阈值，Jest 执行测试时将会失败。 Thresholds specified as a positive number are taken to be the minimum percentage required. Thresholds specified as a negative number represent the maximum number of uncovered entities allowed.For example, with the following configuration jest will fail if there is less than 80% branch, line, and function coverage, or if there are more than 10 uncovered statements:
{ ... "jest": { "coverageThreshold": { "global": { "branches": 80, "functions": 80, "lines": 80, "statements": -10 } } } }If globs or paths are specified alongside
global, coverage data for matching paths will be subtracted from overall coverage and thresholds will be applied independently. 通配符模式设置的阈值将应用到所匹配的所有文件上并单独计算。 If the file specified by path is not found, error is returned.例如，基于下面的配置：
{ ... "jest": { "coverageThreshold": { "global": { "branches": 50, "functions": 50, "lines": 50, "statements": 50 }, "./src/components/": { "branches": 40, "statements": 40 }, "./src/reducers/**/*.js": { "statements": 90 }, "./src/api/very-important-module.js": { "branches": 100, "functions": 100, "lines": 100, "statements": 100 } } } }Jest 在以下情况下将失败：
- The
./src/componentsdirectory has less than 40% branch or statement coverage. - One of the files matching the
./src/reducers/**/*.jsglob has less than 90% statement coverage. - 文件
./src/api/very-important-module.js的任意一种覆盖率低于 100% - 所有剩下的文件的任意一种覆盖率总计低于 50% (根据
global)
dependencyExtractor[string]默认值：
undefinedThis option allows the use of a custom dependency extractor. It must be a node module that exports an object with an
extractfunction. E.g.:const fs = require('fs'); const crypto = require('crypto'); module.exports = { extract(code, filePath, defaultExtract) { const deps = defaultExtract(code, filePath); // Scan the file and add dependencies in `deps` (which is a `Set`) return deps; }, getCacheKey() { return crypto .createHash('md5') .update(fs.readFileSync(__filename)) .digest('hex'); }, };The
extractfunction should return an iterable (Array,Set, etc.) with the dependencies found in the code.That module can also contain a
getCacheKeyfunction to generate a cache key to determine if the logic has changed and any cached artifacts relying on it should be discarded.displayName[string, object]默认值：
undefinedAllows for a label to be printed along side a test while it is running. This becomes more useful in multiproject repositories where there can be many jest configuration files. This visually tells which project a test belongs to. Here are sample valid values.
module.exports = { displayName: 'CLIENT', };或
module.exports = { displayName: { name: 'CLIENT', color: 'blue', }, };As a secondary option, an object with the properties
nameandcolorcan be passed. This allows for a custom configuration of the background color of the displayName.displayNamedefaults to white when its value is a string. Jest uses chalk to provide the color. As such, all of the valid options for colors supported by chalk are also supported by jest.errorOnDeprecated[boolean]默认值︰
falseMake calling deprecated APIs throw helpful error messages. Useful for easing the upgrade process.
extraGlobals[array<string>]默认值：
undefinedTest files run inside a vm, which slows calls to global context properties (e.g.
Math). With this option you can specify extra properties to be defined inside the vm for faster lookups.For example, if your tests call
Mathoften, you can pass it by settingextraGlobals.{ ... "jest": { "extraGlobals": ["Math"] } }forceCoverageMatch[array<string>]Default:
['']Test files are normally ignored from collecting code coverage. With this option, you can overwrite this behavior and include otherwise ignored files in code coverage.
For example, if you have tests in source files named with
.t.jsextension as following:// sum.t.js export function sum(a, b) { return a + b; } if (process.env.NODE_ENV === 'test') { test('sum', () => { expect(sum(1, 2)).toBe(3); }); }你可以通过设置
forceCoverageMatch从这些文件中收集覆盖率。{ ... "jest": { "forceCoverageMatch": ["**/*.t.js"] } }globals[object]默认值：
{}一组全局变量，在所有测试环境下都可以访问。
例如，下面这段代码将为所有测试环境创建一个值为
true的全局变量__DEV__：{ ... "jest": { "globals": { "__DEV__": true } } }注意，如果你在这指定了一个全局引用值（例如，对象或者数组），之后在测试运行中有些代码改变了这个被引用的值，这个改动对于其他测试不会生效。 In addition the
globalsobject must be json-serializable, so it can't be used to specify global functions. 要实现这种功能，应该使用setupFiles。globalSetup[string]默认值：
undefinedThis option allows the use of a custom global setup module which exports an async function that is triggered once before all test suites. This function gets Jest's
globalConfigobject as a parameter.Note: A global setup module configured in a project (using multi-project runner) will be triggered only when you run at least one test from this project.
Note: Any global variables that are defined through
globalSetupcan only be read inglobalTeardown. You cannot retrieve globals defined here in your test suites.Note: While code transformation is applied to the linked setup-file, Jest will not transform any code in
node_modules. This is due to the need to load the actual transformers (e.g.babelortypescript) to perform transformation.示例：
// setup.js module.exports = async () => { // ... // Set reference to mongod in order to close the server during teardown. global.__MONGOD__ = mongod; };// teardown.js module.exports = async function () { await global.__MONGOD__.stop(); };globalTeardown[string]默认值：
undefinedThis option allows the use of a custom global teardown module which exports an async function that is triggered once after all test suites. This function gets Jest's
globalConfigobject as a parameter.Note: A global teardown module configured in a project (using multi-project runner) will be triggered only when you run at least one test from this project.
Note: The same caveat concerning transformation of
node_modulesas forglobalSetupapplies toglobalTeardown.maxConcurrency[number]Default:
5A number limiting the number of tests that are allowed to run at the same time when using
test.concurrent. Any test above this limit will be queued and executed once a slot is released.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_modulesfor packages include it along with any other options:["node_modules", "bower_components"]moduleFileExtensions[array<string>]Default:
["js", "json", "jsx", "ts", "tsx", "node"]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, in left-to-right order.
We recommend placing the extensions most commonly used in your project on the left, so if you are using TypeScript, you may want to consider moving "ts" and/or "tsx" to the beginning of the array.
moduleNameMapper[object<string, string | array<string>>]默认值︰
nullA map from regular expressions to module names or to arrays of 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 tomodulePathIgnorePatterns[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.These pattern strings match against the full path. Use the
<rootDir>string token to include the path to your project's root directory to prevent it from accidentally ignoring all of your files in different environments that may have different root directories. Example:["<rootDir>/build/"].modulePaths[array<string>]默认值：
[]An alternative API to setting the
NODE_PATHenv variable,modulePathsis 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]默认值︰
falseActivates notifications for test results.
Beware: Jest uses node-notifier to display desktop notifications. On Windows, it creates a new start menu entry on the first use and not display the notification. Notifications will be properly displayed on subsequent runs
notifyMode[string]Default:
failure-changeSpecifies notification mode. Requires
notify: true.Modes
always: always send a notification.failure: send a notification when tests fail.success: send a notification when tests pass.change: send a notification when the status changed.success-change: send a notification when tests pass or once when it fails.failure-change: send a notification when tests fail or once when it passes.
preset[string]默认值：
undefinedA preset that is used as a base for Jest's configuration. A preset should point to an npm module that has a
jest-preset.jsonorjest-preset.jsfile at the root.For example, this preset
foo-bar/jest-preset.jswill be configured as follows:{ "preset": "foo-bar" }Presets may also be relative filesystem paths.
{ "preset": "./node_modules/foo-bar/jest-preset.js" }prettierPath[string]Default:
'prettier'Sets the path to the
prettiernode module used to update inline snapshots.projects[array<string | ProjectConfig>]默认值：
undefinedWhen the
projectsconfiguration 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.
The projects feature can also be used to run multiple configurations or multiple
reporters[array<moduleName | [moduleName, options]>]默认值：
undefinedUse this configuration option to add custom reporters to Jest. A custom reporter is a class that implements
onRunStart,onTestStart,onTestResult,onRunCompletemethods 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,
defaultcan 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
optionsobject 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
GlobalConfigand 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; // or export default MyCustomReporter;Custom reporters can also force Jest to exit with non-0 code by returning an Error from
getLastError()methodsclass 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
Reporterinterface in packages/jest-reporters/src/types.tsresetMocks[boolean]默认值︰
falseAutomatically 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.resetModules[boolean]默认值︰
falseBy default, each test file gets its own independent module registry. Enabling
resetModulesgoes a step further and resets the module registry 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 usingjest.resetModules().resolver[string]默认值：
undefinedThis 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, "defaultResolver": "function(request, options)", "extensions": [string], "moduleDirectory": [string], "paths": [string], "rootDir": [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.
Note: the defaultResolver passed as options is the jest default resolver which might be useful when you write your custom one. It takes the same arguments as your custom one, e.g. (request, options).
restoreMocks[boolean]默认值︰
falseAutomatically restore mock state 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.rootDir[string]Default: The root of the directory containing your Jest
roots[array<string>]默认值︰
["<rootDir>"]A list of paths to directories that Jest should use to search for files in.
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
rootDiris mostly used as a token to be re-used in other configuration options,rootsis used by the internals of Jest to locate test files and source files. This applies also when searching for manual mocks for modules fromnode_modules(__mocks__will need to live in one of theroots).Note: By default,
rootshas a single entry<rootDir>but there are cases where you may want to have multiple roots within one project, for exampleroots: ["<rootDir>/src/", "<rootDir>/tests/"].runner[string]Default:
"jest-runner"This option allows you to use a custom runner instead of Jest's default test runner. Examples of runners include:
Note: The
runnerproperty value can omit thejest-runner-prefix of the package name.To write a test-runner, export a class with which accepts
globalConfigin the constructor, and has arunTestsmethod with the signature:async runTests( tests: Array<Test>, watcher: TestWatcher, onStart: OnTestStart, onResult: OnTestSuccess, onFailure: OnTestFailure, options: TestRunnerOptions, ): Promise<void>If you need to restrict your test-runner to only run in serial rather than being executed in parallel your class should have the property
isSerialto be set astrue.setupFiles[array]默认值：
[]A list of paths to modules that run some code to configure or set up the testing environment. Each setupFile will be run once per test file. 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 also worth noting that
setupFileswill execute beforesetupFilesAfterEnv[array]默认值：
[]A list of paths to modules that run some code to configure or set up the testing framework before each test file in the suite is executed. Since
snapshotResolver[string]默认值：
undefinedThe path to a module that can resolve test<->snapshot path. This config option lets you customize where Jest stores snapshot files on disk.
Example snapshot resolver module:
module.exports = { // resolves from test to snapshot path resolveSnapshotPath: (testPath, snapshotExtension) => testPath.replace('__tests__', '__snapshots__') + snapshotExtension, // resolves from snapshot to test path resolveTestPath: (snapshotFilePath, snapshotExtension) => snapshotFilePath .replace('__snapshots__', '__tests__') .slice(0, -snapshotExtension.length), // Example test path, used for preflight consistency check of the implementation above testPathForConsistencyCheck: 'some/__tests__/example.test.js', };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'); }, };serializeis a function that serializes a value using existing plugins.To use
my-serializer-moduleas a serializer, configuration would be as follows:{ ... "jest": { "snapshotSerializers": ["my-serializer-module"] } }Finally tests would look as follows:
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.addSnapshotSerializerto add a module for an individual test file instead of adding its path tosnapshotSerializersin 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
nodeoption to use a node-like environment instead.By adding a
@jest-environmentdocblock at the top of the file, you can specify another environment to be used for all tests in that file:/** * @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
setup,teardownandrunScriptmethods. You can also pass variables from this module to your test suites by assigning them tothis.globalobject – this will make them available in your test suites as global variables.The class may optionally expose an asynchronous
handleTestEventmethod to bind to events fired byjest-circus. Normally,jest-circustest runner would pause until a promise returned fromhandleTestEventgets fulfilled, except for the next events:start_describe_definition,finish_describe_definition,add_hook,add_testorerror(for the up-to-date list you can look at SyncEvent type in the types definitions). That is caused by backward compatibility reasons andprocess.on('unhandledRejection', callback)signature, but that usually should not be a problem for most of the use cases.Any docblock pragmas in test files will be passed to the environment constructor and can be used for per-test configuration. If the pragma does not have a value, it will be present in the object with it's value set to an empty string. If the pragma is not present, it will not be present in the object.
Note: TestEnvironment is sandboxed. Each test suite will trigger setup/teardown in their own TestEnvironment.
示例：
// my-custom-environment const NodeEnvironment = require('jest-environment-node'); class CustomEnvironment extends NodeEnvironment { constructor(config, context) { super(config, context); this.testPath = context.testPath; this.docblockPragmas = context.docblockPragmas; } async setup() { await super.setup(); await someSetupTasks(this.testPath); this.global.someGlobalObject = createGlobalObject(); // Will trigger if docblock contains @my-custom-pragma my-pragma-value if (this.docblockPragmas['my-custom-pragma'] === 'my-pragma-value') { // ... } } async teardown() { this.global.someGlobalObject = destroyGlobalObject(); await someTeardownTasks(); await super.teardown(); } runScript(script) { return super.runScript(script); } async handleTestEvent(event, state) { if (event.name === 'test_start') { // ... } } } module.exports = CustomEnvironment;// my-test-suite let someGlobalObject; beforeAll(() => { someGlobalObject = global.someGlobalObject; });testEnvironmentOptions[Object]默认值：
{}Test environment options that will be passed to the
testEnvironment. The relevant options depend on the environment. For example you can override options given to jsdom such as{userAgent: "Agent/007"}.testMatch[array<string>](default:
[ "**/__tests__/**/*.[jt]s?(x)", "**/?(*.)+(spec|test).[jt]s?(x)" ])The glob patterns Jest uses to detect test files. By default it looks for
.js,.jsx,.tsand.tsxfiles inside of__tests__folders, as well as any files with a suffix of.testor.spec(e.g.Component.test.jsorComponent.spec.js). It will also find files calledtest.jsorspec.js.See the micromatch package for details of the patterns you can specify.
See also
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.
These pattern strings match against the full path. Use the
<rootDir>string token to include the path to your project's root directory to prevent it from accidentally ignoring all of your files in different environments that may have different root directories. Example:["<rootDir>/build/", "<rootDir>/node_modules/"].testRegex[string | array<string>]Default:
(/__tests__/.*|(\\.|/)(test|spec))\\.[jt]sx?$The pattern or patterns Jest uses to detect test files. By default it looks for
.js,.jsx,.tsand.tsxfiles inside of__tests__folders, as well as any files with a suffix of.testor.spec(e.g.Component.test.jsorComponent.spec.js). It will also find files calledtest.jsorspec.js. See alsotestResultsProcessor[string]默认值：
undefinedThis 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 and return it:
{ "success": bool, "startTime": epoch, "numTotalTestSuites": number, "numPassedTestSuites": number, "numFailedTestSuites": number, "numRuntimeErrorTestSuites": number, "numTotalTests": number, "numPassedTests": number, "numFailedTests": number, "numPendingTests": number, "numTodoTests": number, "openHandles": Array<Error>, "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, "location": { "column": number, "line": number } }, ... ], "perfStats": { "start": epoch, "end": epoch }, "testFilePath": absolute path to test file, "coverage": {} }, ... ] }testRunner[string]默认值︰
jasmine2This 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( globalConfig: GlobalConfig, config: ProjectConfig, environment: Environment, runtime: Runtime, testPath: string, ): Promise<TestResult>;An example of such function can be found in our default jasmine2 test runner package.
testSequencer[string]Default:
@jest/test-sequencerThis option allows you to use a custom sequencer instead of Jest's default.
sortmay optionally return a Promise.示例：
Sort test path alphabetically.
const Sequencer = require('@jest/test-sequencer').default; class CustomSequencer extends Sequencer { sort(tests) { // Test structure information // https://github.com/facebook/jest/blob/6b8b1404a1d9254e7d5d90a8934087a9c9899dab/packages/jest-runner/src/types.ts#L17-L21 const copyTests = Array.from(tests); return copyTests.sort((testA, testB) => (testA.path > testB.path ? 1 : -1)); } } module.exports = CustomSequencer;testTimeout[number]Default:
5000默认测试超时时间单位为毫秒。
testURL[string]Default:
http://localhostThis option sets the URL for the jsdom environment. It is reflected in properties such as
location.href.timers[string]默认值︰
realSetting this value to
fakeallows the use of fake timers for functions such assetTimeout. 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, pathToTransformer | [pathToTransformer, object]>]默认值：
undefinedA 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
- async-to-gen
- To build your own please visit the Custom Transformer section
You can pass configuration to a transformer like
{filePattern: ['path-to-transformer', {options}]}For example, to configure babel-jest for non-default behavior,{"\\.js$": ['babel-jest', {rootMode: "upward"}]}Note: a transformer is only run once per file unless the file has changed. During development of a transformer it can be useful to run Jest with
--no-cacheto frequently delete Jest's cache.Note: if you are using the
babel-jesttransformer and want to use an additional code preprocessor, keep in mind that when "transform" is overwritten in any way thebabel-jestis not loaded automatically anymore. If you want to use it to compile JavaScript code it has to be explicitly defined. See babel-jest plugintransformIgnorePatterns[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.
These pattern strings match against the full path. Use the
<rootDir>string token to include the path to your project's root directory to prevent it from accidentally ignoring all of your files in different environments that may have different root directories.Example:
["<rootDir>/bower_components/", "<rootDir>/node_modules/"].Sometimes it happens (especially in React Native or TypeScript projects) that 3rd party modules are published as untranspiled. Since all files inside
node_modulesare not transformed by default, Jest will not understand the code in these modules, resulting in syntax errors. To overcome this, you may usetransformIgnorePatternsto whitelist such modules. You'll find a good example of this use case in React Native Guide.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]默认值︰
falseIndicates whether each individual test should be reported during the run. All errors will also still be shown on the bottom after execution. Note that if there is only one test file being run it will default to
true.watchPathIgnorePatterns[array<string>]默认值：
[]An array of RegExp patterns that are matched against all source file paths before re-running tests in watch mode. If the file path matches any of the patterns, when it is updated, it will not trigger a re-run of tests.
These patterns match against the full path. Use the
<rootDir>string token to include the path to your project's root directory to prevent it from accidentally ignoring all of your files in different environments that may have different root directories. Example:["<rootDir>/node_modules/"].Even if nothing is specified here, the watcher will ignore changes to any hidden files and directories, i.e. files and folders that begins with a dot (
.).watchPlugins[array<string | [string, Object]>]默认值：
[]This option allows you to use a custom watch plugins. Read more about watch plugins here.
Examples of watch plugins include:
jest-watch-masterjest-watch-select-projectsjest-watch-suspendjest-watch-typeaheadjest-watch-yarn-workspaces
Note: The values in the
watchPluginsproperty value can omit thejest-watch-prefix of the package name.//[string]No default
This option allow comments in
package.json. Include the comment text as the value of this key anywhere inpackage.json.示例：
{ "name": "my-project", "jest": { "//": "Comment goes here", "verbose": true } } - Your node version must include