23.x

Edit

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

Sau prin intermediul JavaScript:

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

Reţineţi că toată configuraţia care rezultă trebuie să fie serializabilă JSON.

When using the --config option, the JSON file must not contain a "jest" key:

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

Opțiuni

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

You can retrieve Jest's default options to expand them if needed:

// jest.config.js
const {defaults} = require('jest-config');
module.exports = {
  // ...
  moduleFileExtensions: [...defaults.moduleFileExtensions, 'ts', 'tsx'],
  // ...
};

Referințe

automock [boolean]

Implicit: false

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

Exemplu:

// 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, like jest.mock('fs').

bail [boolean]

Implicit: false

By 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 the first failure.

browser [boolean]

Implicit: false

Respectă câmpul "browser" al Browserify în package.json când se rezolvă modulele. Unele module exportă versiuni diferite dacă operează în Node sau browser.

cacheDirectory [string]

Implicit: "/tmp/<path>"

Directorul unde Jest va stoca informaţiile sale de dependenţe.

Jest încearcă să scaneze arborele de dependenţe o dată şi îl memorează pentru a ușura lucrul cu sistemul de fişiere care trebuie să se întâmple în timp ce rulează teste. Această opţiune de configurare vă permite să particularizaţi unde Jest stochează datele pe disc.

clearMocks [boolean]

Implicit: false

Automatically clear mock calls and instances before every test. Equivalent to calling jest.clearAllMocks() before each test. Aceasta nu elimină nicio implementare de dubluri, ce a fost furnizată.

collectCoverage [boolean]

Implicit: false

Indică dacă informaţiile de acoperire a codului trebuie să fie colectate în timpul execuției. Deoarece aceasta adaugă în toate fişierele executate declaraţii de colectare a acoperirii, poate încetini semnificativ testele.

collectCoverageFrom [array]

Implicit: undefined

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

Exemplu:

{
  "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/**.

Notă: Această opţiune necesită ca opțiunea collectCoverage să fie setată "true" sau Jest să fie invocat cu --coverage.

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]

Implicit: undefined

Directorul unde Jest ar trebui să salveze fişierele sale de acoperire.

coveragePathIgnorePatterns [array<string>]

Implicit: ["/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.

Aceste reguli sunt comparate față de calea completă. Utilizaţi cuvântul cheie <rootDir> pentru a include calea către directorul rădăcină din proiectul vostru pentru a preveni ignorarea accidentală a fișierelor în medii diferite, care pot avea diferite directoare rădăcină. Exemplu: ["<rootDir>/build/", "<rootDir>/node_modules/"].

coverageReporters [array<string>]

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.

coverageThreshold [object]

Implicit: undefined

Acesta va fi utilizat pentru a configura pragul minim de acoperire. Thresholds can be specified as global, as a glob, and as a directory or file path. If thresholds aren't met, jest will fail. 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. Thresholds for globs are applied to all files matching the glob. If the file specified by path is not found, an error is returned.

For example, with the following configuration:

{
  ...
  "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 will fail if:

  • The ./src/components directory has less than 40% branch or statement coverage.
  • One of the files matching the ./src/reducers/**/*.js glob has less than 90% statement coverage.
  • The ./src/api/very-important-module.js file has less than 100% coverage.
  • Every remaining file combined has less than 50% coverage (global).

displayName [string]

implicit: undefined

Allows for a label to be printed alongside a test while it is running. This becomes more useful in multi-project repositories where there can be many jest configuration files. This visually tells which project a test belongs to.

errorOnDeprecated [boolean]

Implicit: false

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

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.js extension 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);
  });
}

You can collect coverage from those files with setting forceCoverageMatch.

{
  ...
  "jest": {
    "forceCoverageMatch": ["**/*.t.js"]
  }
}

globals [object]

Implicit: {}

Un set de variabile globale care trebuie să fie disponibile în toate mediile de testare.

De exemplu, următorul cod ar crea o variabilă globală __DEV__ cu valoarea true în toate mediile de testare:

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

Reţineţi că, dacă specificaţi o valoare de referinţă la nivel global (cum ar fi un obiect sau un array), şi în mijlocul execuției unui test se modifică această valoare, modificarea nu va persista în rularea testelor pentru alte fişiere de test. In addition, the globals object must be json-serializable, so it can't be used to specify global functions. For that, you should use setupFiles.

globalSetup [string]

Implicit: undefined

This 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 globalConfig object as a parameter.

globalTeardown [string]

Implicit: undefined

This 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 globalConfig object as a parameter.

haste [object]

Implicit: undefined

This will be used to configure the behavior of jest-haste-map, Jest's internal file crawler/cache system. The following options are supported:

type HasteConfig = {
  // Whether to hash files using SHA-1.
  computeSha1?: boolean;
  // The platform to use as the default, e.g. 'ios'.
  defaultPlatform?: string | null;
  // Path to a custom implementation of Haste.
  hasteImplModulePath?: string;
  // All platforms to target, e.g ['ios', 'android'].
  platforms?: Array<string>;
  // Whether to throw on error on module collision.
  throwOnModuleCollision?: boolean;
};

moduleDirectories [array<string>]

Implicit: ["node_modules"]

O serie de nume de directoare care vor fi cautate recursiv pentru locaţia modulelor incluse. 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"]

moduleFileExtensions [array<string>]

Implicit: ["js", "json", "jsx", "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.

If you are using TypeScript, you will want to add "ts" and/or "tsx" to the above default. Where you place these is up to you - we recommend placing the extensions most commonly used in your project on the left.

moduleNameMapper [object<string, string>]

Implicit: null

O mapare între expresii regulate și nume de module, care permit dublarea unor resurse, cum ar fi imagini sau stiluri, cu un singur alt modul.

Modulele care sunt mapate la un alias sunt de-dublate în mod implicit, indiferent dacă dublarea automată este activată sau nu.

Utilizaţi <rootDir> pentru a vă referi la valoarea rootDir, dacă doriţi să utilizaţi căi de fişier.

În plus, puteţi înlocui grupuri capturate cu regex folosind referințe numerotate.

Exemplu:

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

The order in which the mappings are defined matters. Patterns are checked one by one until one fits. The most specific rule should be listed first.

Notă: Dacă folosiți nume fără limite ^$ pot apărea erori greu de identificat. Ex. relay va înlocui toate modulele care contin relay în nume: relay, react-relay şi graphql-relay vor fi redirecționate către dublură.

modulePathIgnorePatterns [array<string>]

Implicit: []

Un array de expresii regulate care sunt comparate cu toate căile de module, înainte de acestea să fie considerate 'vizibile' pentru încărcătorul de module. În cazul în care calea unui modul se potriveşte cu oricare dintre modele, acesta nu va fi require()-uit în mediul de testare.

Aceste reguli sunt comparate față de calea completă. Utilizaţi cuvântul cheie <rootDir> pentru a include calea către directorul rădăcină din proiectul vostru pentru a preveni ignorarea accidentală a fișierelor în medii diferite, care pot avea diferite directoare rădăcină. Exemplu: ["<rootDir>/build/"].

modulePaths [array<string>]

Implicit: []

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. Utilizaţi atributul <rootDir> pentru a include rădăcina proiectului vostru. Exemplu: ["<rootDir>/app/"].

notify [boolean]

Implicit: false

Activează afișsarea de notificări pentru rezultatele testelor.

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: always

Specifies 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]

Implicit: undefined

A preset that is used as a base for Jest's configuration. A preset should point to an npm module that has a jest-preset.json or jest-preset.js file at the root.

For example, this preset foo-bar/jest-preset.js will be configured as follows:

{
  "preset": "foo-bar"
}

Presets may also be relative to filesystem paths.

{
  "preset": "./node_modules/foo-bar/jest-preset.js"
}

prettierPath [string]

Default: 'prettier'

Sets the path to the prettier node module used to update inline snapshots.

projects [array<string | projectconfig>]

Implicit: undefined

Atunci când configuraţia projects este completată cu o serie de căi sau tipare glob, Jest va rula testele în toate proiectele specificate, în acelaşi timp. Acest lucru este util pentru proiecte monolit sau atunci când se lucrează pe mai multe proiecte în acelaşi timp.

{
  "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 runners. For this purpose, you can pass an array of configuration objects. For example, to run both tests and ESLint (via jest-runner-eslint) in the same invocation of Jest:

{
  "projects": [
    {
      "displayName": "test"
    },
    {
      "displayName": "lint",
      "runner": "jest-runner-eslint",
      "testMatch": ["<rootDir>/**/*.js"]
    }
  ]
}

Note: When using multi-project runner, it's recommended to add a displayName for each project. This will show the displayName of a project next to its tests.

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

Implicit: undefined

Utilizaţi această opţiune de configurare pentru a adăuga tipuri personalizate de raportări Jest. Un reporter personalizat este o clasă care implementează metodele onRunStart, onTestStart, onTestResult, onRunComplete, ce vor fi apelate atunci când oricare din aceste evenimente survine.

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

Acest lucru va suprascrie reporterii impliciți:

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

Acest lucru va utiliza reporterul personalizat în plus faţă de cei impliciți pe care Jest îi oferă:

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

În plus, reporterii personalizați pot fi configurați prin pasarea unui obiect options ca al doilea argument:

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

Modulele pentru reporteri personalizați trebuie să definească o clasă care primește GlobalConfig şi un obiect "options" ca argumente în constructor:

Exemplu de 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;

Reporterii personalizați pot forţa Jest să-ți termine execuția cu cod non-0 prin returnarea unui obiect Error în metoda getLastError()

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 interface in packages/jest-reporters/src/types.ts

resetMocks [boolean]

Implicit: false

Automatically reset mock state before every test. Equivalent to calling jest.resetAllMocks() before each test. Acest lucru va conduce la eliminearea implementării false pentru toate dublurile, dar nu restaurează implementarea lor iniţială.

resetModules [boolean]

Implicit: false

By default, each test file gets its own independent module registry. Enabling resetModules goes a step further and resets the module registry before running each individual test. This is useful to isolate modules for every test so that the local module state doesn't conflict between tests. Acest lucru se poate face programatic folosind jest.resetModules().

resolver [string]

Implicit: undefined

Această opţiune permite utilizarea unei metode personalizate pentru rezolvarea modulelor. Acest instrument de rezolvare trebuie să fie un modul Node care exportă o funcţie ce aşteaptă ca prim argument un şir de caractere pentru calea de rezolvat şi un obiect cu următoarea structură ca al doilea argument:

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

Funcţia ar trebui să returneze fie calea către modulul care ar trebui să fie rezolvat sau să arunce o eroare în cazul în care modulul nu poate fi găsit.

restoreMocks [boolean]

Implicit: false

Automatically 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 config file or the package.json or the pwd if no package.json is found

Directorul rădăcină în care Jest ar trebui să caute teste şi module. Dacă puneți configurarea Jest în interiorul fișierului package.json şi doriţi ca directorul rădăcină a fie rădăcina proiectului vostru, valoarea pentru această configurare va fi implicit directorul cu package.json.

Deseori, veţi dori să setați această valoare la "src" sau "lib", corespunzător locației unde stocați codul sursă.

Reţineţi că folosind '<rootDir>' în orice altă configurare de căi, va referi înapoi la această valoare. De exemplu, dacă doriţi configurarea setupFiles să indice către fișierul env-setup.js din rădăcina proiectul vostru, puteți seta valoarea sa la ["<rootDir>/env-setup.js"].

roots [array<string>]

Implicit: ["<rootDir>"]

O listă de căi de directoare pe care Jest ar trebui să le utilizeze pentru a căuta fișiere.

Există cazuri în care doriţi ca Jest să căute într-un singur sub-director (în cazul în care aveţi un director src/), dar doriți să preveniți accesarea celorlalte directoare.

Notă: În timp ce rootDir este folosit mai ales ca un simbol pentru reutilizare în alte opţiuni de configurare, roots este folosit intern de Jest pentru a localiza fişierele test și sursă. Acest lucru se aplică și atunci când se caută mock-uri manuale pentru module din node_modules (__mocks__ va trebui să fie într-una din rădăcini).

Notă: În mod implicit, roots are o singură intrare <rootDir>, dar există cazuri în care v-ați dori să aveţi mai multe rădăcini într-un proiect, de exemplu roots: ["<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:

To write a test-runner, export a class with which accepts globalConfig in the constructor, and has a runTests method 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 isSerial to be set as true.

setupFiles [array]

Implicit: []

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. Deoarece fiecare test se execută în propriul său mediu, aceste module vor fi executate în mediul de testare imediat înainte de execuția codului de testare în sine.

It's also worth noting that setupFiles will execute before setupTestFrameworkScriptFile.

setupTestFrameworkScriptFile [string]

Implicit: undefined

The path to a module that runs some code to configure or set up the testing framework before each test file in the suite is executed. Deoarece setupFiles se execută înainte de instalarea framework-ului în mediul de testare, această opțiune vă oferă posibilitatea de a rula bucăți de cod imediat după ce framework-ul a fost instalat în mediul de testare.

If you want a path to be relative to the root directory of your project, please include <rootDir> inside a path's string, like "<rootDir>/a-configs-folder".

De exemplu, Jest este livrat cu mai multe plug-in-uri jasmine, care modifică API-ul jasmine. 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 these modules.

Example setupTestFrameworkScriptFile in a jest.config.js:

module.exports = {
  setupTestFrameworkScriptFile: './jest.setup.js',
};

Example jest.setup.js file

jest.setTimeout(10000); // in milliseconds

snapshotSerializers [array<string>]

Implicit: []

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.

Exemplu de modul serializator:

// my-serializer-module
module.exports = {
  serialize(val, config, indentation, depth, refs, printer) {
    return 'Pretty foo: ' + printer(val.foo);
  },

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

printer is a function that serializes a value using existing plugins.

To use my-serializer-module as a serializer, configuration would be as follows:

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

În cele din urmă testul ar arăta după cum urmează:

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

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

Imaginea obținută:

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

Pentru a face o dependenţă explicită, nu implicită, puteţi apela expect.addSnapshotSerializer pentru a adăuga un modul pentru un fişier individual de test, în loc de adăugarea sa în configurarea snapshotSerializers.

More about serializers API can be found here.

testEnvironment [string]

Implicit: "jsdom"

Mediul de testare care va fi utilizat pentru testare. Mediul implicit în Jest este un mediu similar unui browser, și anume jsdom. În cazul în care dezvoltați un serviciu nodejs, utilizaţi opţiunea node pentru a folosi un mediu similar cu nodejs.

By adding a @jest-environment docblock 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();
});

Puteţi crea propriile module care vor fi folosite pentru configurarea mediul de testare. The module must export a class with setup, teardown and runScript methods. You can also pass variables from this module to your test suites by assigning them to this.global object – this will make them available in your test suites as global variables.

To use this class as your custom environment, refer to it by its full path within the project. For example, if your class is stored in my-custom-environment.js in some subfolder of your project, then the annotation might looke like this:

/**
 * @jest-environment ./src/test/my-custom-environment
 */

Note: TestEnvironment is sandboxed. Each test suite will trigger setup/teardown in their own TestEnvironment.

Exemplu:

// 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);
  }
}

module.exports = CustomEnvironment;

// my-test-suite
/**
 * @jest-environment ./my-custom-environment
 */
let someGlobalObject;

beforeAll(() => {
  someGlobalObject = global.someGlobalObject;
});

Note: Jest comes with JSDOM@11 by default. Due to JSDOM 12 and newer dropping support for Node 6, Jest is unable to upgrade for the time being. However, you can install a custom testEnvironment with whichever version of JSDOM you want. E.g. jest-environment-jsdom-thirteen, which has JSDOM@13.

testEnvironmentOptions [Object]

Implicit: {}

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

testFailureExitCode [number]

Default: 1

The exit code Jest returns on test failure.

Note: This does not change the exit code in the case of Jest errors (e.g. invalid configuration).

testMatch [array<string>]

(default: [ "**/__tests__/**/*.js?(x)", "**/?(*.)+(spec|test).js?(x)" ])

Modele glob pe care Jest le utilizează pentru a detecta fişiere de test. 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>]

Implicit: ["/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.

Aceste reguli sunt comparate față de calea completă. Utilizaţi cuvântul cheie <rootDir> pentru a include calea către directorul rădăcină din proiectul vostru pentru a preveni ignorarea accidentală a fișierelor în medii diferite, care pot avea diferite directoare rădăcină. Exemplu: ["<rootDir>/build/", "<rootDir>/node_modules/"].

testRegex [string]

Implicit: (/__tests__/.*|(\\.|/)(test|spec))\\.jsx?$

Modele glob pe care Jest le utilizează pentru a detecta fişiere de test. 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.

Aceasta este o vizualizare a opțiunii implicite:

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

Note: testRegex will try to detect test files using the absolute file path, therefore, having a folder with a name that matches it will run all the files as tests

testResultsProcessor [string]

Implicit: 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 and return it:

{
  "success": boolean,
  "startTime": epoch,
  "numTotalTestSuites": number,
  "numPassedTestSuites": number,
  "numFailedTestSuites": number,
  "numRuntimeErrorTestSuites": number,
  "numTotalTests": number,
  "numPassedTests": number,
  "numFailedTests": number,
  "numPendingTests": 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]

Implicit: jasmine2

This option allows the 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.

Un astfel de modul trebuie să exporte o funcţie cu următoarea semnătură:

function testRunner(
  globalConfig: GlobalConfig,
  config: ProjectConfig,
  environment: Environment,
  runtime: Runtime,
  testPath: string,
): Promise<TestResult>;

Un exemplu de astfel de funcţie poate fi găsită în modulul nostru implicit jasmine2.

testURL [string]

Default: http://localhost

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

timers [string]

Implicit: real

Setarea acestei valori cu fake permite utilizarea de cronometre false pentru funcţii precum setTimeout. Cronometrele false sunt utile atunci când o bucată de cod stabileşte o pauză lungă pe care nu dorim să o aşteptăm într-un test.

transform [object<string, pathToTransformer | [pathToTransformer, object]>]

Default: {"^.+\\.[jt]sx?$": "babel-jest"}

O mapare între expresii regulate către căi de transformatoare. Un transformator este un modul care oferă o funcţie sincron pentru transformarea fişierele sursă. For example, if you wanted to be able to use a new language feature in your modules or tests that aren'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:

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

Note: when adding additional code transformers, this will overwrite the default config and babel-jest is no longer automatically loaded. If you want to use it to compile JavaScript or Typescript, it has to be explicitly defined by adding {"\\.[jt]sx?$": "babel-jest"} to the transform property. A se vedea babel-jest plugin

transformIgnorePatterns [array<string>]

Implicit: ["/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.

Aceste reguli sunt comparate față de calea completă. Utilizaţi cuvântul cheie <rootDir> pentru a include calea către directorul rădăcină din proiectul vostru pentru a preveni ignorarea accidentală a fișierelor în medii diferite, care pot avea diferite directoare rădăcină.

Exemplu: ["<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_modules are not transformed by default, Jest will not understand the code in these modules, resulting in syntax errors. To overcome this, you may use transformIgnorePatterns to allow transpiling such modules. You'll find a good example of this use case in React Native Guide.

unmockedModulePathPatterns [array<string>]

Implicit: []

O serie de expresii regulate care sunt comparate cu toate modulele inainte sa se returneze o dublare automată a lor. Pentru toate fișierele care se potrivesc cu oricare dintre modele din această listă, acesta nu va fi dublat automat.

Aceasta este utilă pentru unele module 'utilitare' frecvente, care sunt aproape întotdeauna utilizate ca detalii de implementare (cum ar fi underscore/lo-dash, etc). În general este o bună practică pentru a păstra această listă cât mai scurtă posibil şi folosirea explicită a jest.mock() / jest.unmock() în teste individuale. Configurare explicită per test este mult mai uşoară pentru alţi cititori ai testului privind înțelegerea mediului în care va rula testul.

Este posibilă suprascrierea aceastei setări în teste individuale prin apelul explicit jest.mock() în partea de sus a fişierului de testare.

verbose [boolean]

Implicit: false

Indicates 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>]

Implicit: []

O listă de tipare RegExp care sunt comparate cu toate căile fişierelor sursă înainte de a re-rula testele în modul de veghe. În cazul în care calea de fişier se potriveşte cu oricare dintre modele, atunci când acesta este actualizat, nu se va declanşa o re-rulare a testelor.

Aceste tipare sunt comparate față de calea completă. Utilizaţi cuvântul cheie <rootDir> pentru a include calea către directorul rădăcină din proiectul vostru pentru a preveni ignorarea accidentală a fișierelor în medii diferite, care pot avea diferite directoare rădăcină. Exemplu: ["<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 begin with a dot (.).

watchPlugins [array<string | [string, object]>]

Implicit: []

This option allows you to use custom watch plugins. Read more about watch plugins here.

Examples of watch plugins include:

watchman [boolean]

Default: true

Whether to use watchman for file crawling.

← The Jest ObjectJest CLI Options →