jest-util

Features

• jest-core: Add findRelatedTests and nonFlagArgs in allowed config options for updateConfigAndRun in watch plugins

Fixes

• babel-plugin-jest-hoist: Preserve order of hoisted mock nodes within containing block

• babel-plugin-jest-hoist: Hoist pure constants to support experimental JSX transform in hoisted mocks

• babel-preset-jest: Update babel-preset-current-node-syntax to support top level await

• expect: Revert "Fix objectContaining to work recursively into sub-objects (#10508)"

• jest-circus, jest-jasmine2: Don't assume stack is always a string

• jest-config: Fix bug introduced in watch mode by PR #10678

• jest-config: Throw correct error for missing preset modules

• jest-resolve-dependencies: Resolve mocks as dependencies

• jest-runtime: Handle file URLs in dynamic imports

• jest-runtime, babel-jest: Pass more ESM options to @jest/transform

• jest-runtime: Properly inject extraGlobals into the runtime

• jest-transform: Link to ESM docs on syntax errors

Features

• jest-runtime: Support named exports from CommonJS as named ES Module imports

• jest-validate: Add support for recursiveDenylist option as an alternative to recursiveBlacklist

Fixes

• expect: Fix objectContaining to work recursively into sub-objects

• jest-cli, jest-core, jest-config, jest-types: Fix --onlyFailures flag to work in non-watch mode

• jest-config: Fix for the jest.config.ts compiler to not interfere with tsconfig.json files

• jest-message-util: Update to work properly with Node 15

• jest-mock: Allow to mock methods in getters (TypeScript 3.9 export)

Features

• jest-cli, jest-config: Add support for the jest.config.ts configuration file

Fixes

• jest-config: Simplify transform RegExp

• jest-fake-timers: Lazily instantiate mock timers

• jest-runtime: require.main is no longer undefined when using jest.resetModules

• @jest/types: Add missing values for timers

Features

• jest-circus, jest-config, jest-runtime: Add new injectGlobals config and CLI option to disable injecting global variables into the runtime

• jest-each: Fixes .each type to always be callable

• jest-runner: Add support for moduleLoaders with default exports

• @jest/create-cache-key-function: Added a new package for creating cache keys

Fixes

• jest-circus, jest-jasmine2: Find correct location for test.each tests

• jest-console: Add Console constructor to console object

• jest-globals: Fix lifecycle hook function types

• jest-runtime: Remove usage of vm.compileFunction due to a performance issue

Features

• jest-circus, jest-jasmine2: Include failureDetails property in test results

• jest-each, jest-jasmine, jest-circus: Add support for .concurrent.each

Fixes

• jest-config: Add .pnp.js to transformIgnorePatterns defaults

• jest-leak-detector: Wait properly for GC runs due to changes in Node 14.7

• breaking

  jest-worker: Downgrade minimum node version to 10.13

Features

• [jest-core, jest-circus, jest-reporter, jest-runner] Added support for reporting individual test cases using jest-circus

• [jest-config, jest-reporter, jest-runner, jest-test-sequencer] Add slowTestThreshold configuration option

• jest-haste-map: Watchman crawler now includes dotfiles

• jest-worker: Added support for workers to send custom messages to parent in jest-worker

• jest-worker: Support passing resourceLimits

• pretty-format: Added support for serializing custom elements (web components)

Fixes

• expect: Match symbols and bigints in any()

• jest-changed-files: Use git diff instead of git log for --changedSince

• jest-console: Add missing console.timeLog for compatibility with Node

• jest-haste-map: Check find binary supports the -iname parameter

• jest-snapshot: Strip added indentation for inline error snapshots

Features

• jest-mock: Export Mock, MockInstance, SpyInstance types

• jest-config: Support config files exporting (async) functions

• jest-cli, jest-core: Add --selectProjects CLI argument to filter test suites by project name

• jest-cli, jest-init: Add coverageProvider to jest --init prompts

Fixes

• jest-console: getConsoleOutput to receive global stack trace config and use it to format stack trace

• jest-jasmine2: Stop adding : after an error that has no message

• jest-diff: Control no diff message color with commonColor in diff options

• jest-snapshot: Fix TypeScript compilation

Performance

• jest-core, jest-transform, jest-haste-map: Improve Jest startup time and test runtime, particularly when running with coverage, by caching micromatch and avoiding recreating RegExp instances

Features

• breaking

  jest-environment-jsdom: Upgrade jsdom to v16

• @jest/fake-timers: Add possibility to use a modern implementation of fake timers, backed by @sinonjs/fake-timers

• jest-runtime: Add createMockFromModule as an alias for genMockFromModule

Fixes

• babel-jest: Handle null being passed to createTransformer

• [jest-circus, jest-console, jest-jasmine2, jest-reporters, jest-util, pretty-format] Fix time durating formatting and consolidate time formatting code

• breaking

  jest-circus: Fail tests if a test takes a done callback and have return values

• breaking

  jest-circus: Throw a proper error if a test / hook is defined asynchronously

• jest-circus: Throw more descriptive error if hook is defined inside test

• breaking

  jest-circus: Align execution order of tests to match jasmine's top to bottom order

• breaking

  jest-config, jest-resolve: Remove support for browser field

• jest-haste-map: Stop reporting files as changed when they are only accessed

• jest-resolve: Show relative path from root dir for module not found errors

• jest-runtime: Fix absolute path moduleNameMapper + jest.mock bug

Chore & Maintenance

• breaking

  *: TypeScript definitions requires a minimum of TypeScript v3.8

• breaking

  *: Drop support for Node 8

• breaking

  expect, jest-mock, pretty-format: Remove build-es5 from package

• breaking

  @jest/fake-timers, @jest/environment: Rename LolexFakeTimers to ModernFakeTimers

• breaking

  jest-haste-map: Removed providesModuleNodeModules

• breaking

  jest-runtime: Remove long-deprecated require.requireActual and require.requireMock methods

Features

• @jest/globals: New package so Jest's globals can be explicitly imported

• jest-core: Show coverage of sources related to tests in changed files

• jest-runtime: Populate require.cache

Fixes

• *: Use graceful-fs directly in every package instead of relying on fs being monkey patched

• expect: Prints the Symbol name into the error message with a custom asymmetric matcher

• jest-circus, jest-jasmine2: Support older version of jest-runtime (#9903 & #9842)

• @jest/environment: Make sure not to reference Jest types

• jest-message-util: Code frame printing should respect --noStackTrace flag

• jest-runtime: Support importing CJS from ESM using import statements

• jest-runtime: Support importing parallel dynamic imports

• jest-transform: Improve source map handling when instrumenting transformed code

Performance

• jest-resolve: Update resolve to a version using native realpath, which is faster than the default JS implementation

• jest-resolve: Pass custom cached realpath function to resolve

• jest-runtime: Add teardown method to clear any caches when tests complete

• jest-runtime: Do not pass files required internally through transformation when loading them

• jest-runtime: Use Maps instead of object literals as cache holders

• expect: Support async functions in toThrow

• jest-console: Add code frame to console.error and console.warn

• jest-runtime, jest-jasmine2, jest-circus: Experimental, limited ECMAScript Modules support (#9772 & #9842)

Fixes

• expect: Restore support for passing functions to toHaveLength matcher

• jest-changed-files: --only-changed should include staged files

• jest-circus: Throw on nested test definitions

• jest-each: each will throw an error when called with too many arguments

• jest-runner: Don't print warning to stdout when using --json

Features

• babel-jest: Support passing supportsDynamicImport and supportsStaticESM

• babel-preset-jest: Enable all syntax plugins not enabled by default that works on current version of Node

• jest-circus: Enable writing async test event handlers

• jest-runtime, @jest/transformer: Support passing supportsDynamicImport and supportsStaticESM

Fixes

• @jest/console: Fix typescript<@3.8 compatibility in published types

Features

• jest-config: Support ESM config files with .js extension (#9573).

• jest-runtime: Override module.createRequire to return a Jest-compatible require function

• breaking

  jest-haste-map: Remove mapper option

• *: Support array of paths for moduleNameMapper aliases

• jest-reporters: Adds ability to pass options to the istanbul-reporter through coverageReporters

• jest-runtime: Require stack when a module cannot be resolved

• jest-transform: writeCacheFile no longer calls fsync

Fixes

• expect: Handle readonly properties correctly

• jest-cli: Set coverageProvider correctly when provided in config

• jest-cli: Allow specifying .cjs and .mjs config files by --config CLI option

• jest-cli: Update yargs to fix CLI flag overriding

• jest-config: Treat setupFilesAfterEnv like setupFiles when normalizing configs against presets

• jest-config: Support .mjs config files on Windows as well

• jest-config: Verify rootDir and all roots are directories

• jest-config: Ensure pattern of replacePosixSep is a string

• jest-haste-map: Fix crash on unix based systems without find

• jest-jasmine2: Fix --testNamePattern matching with concurrent tests

• jest-matcher-utils: Fix diff highlight of symbol-keyed object.

• @jest/reporters: Notifications should be fire&forget rather than having a timeout

• jest-resolve: Fix module identity preservation with symlinks and browser field resolution

• jest-resolve: Do not confuse directories with files

• jest-resolve: moduleNameMapper should take precedence over Node core modules

• jest-runtime: Reset isolateModules if it fails

• jest-runtime: Yarn PnP errors displayed to the user

• jest-snapshot: Downgrade semver to v6 to support node 8

• jest-snapshot: Properly indent new snapshots in the presences of existing ones

• jest-transform: Correct sourcemap behavior for transformed and instrumented code

• jest-transform: Allow instrumentation of transformed files with weird file extensions

• @jest/types: Make ConfigGlobals an interface to allow for declaration merging.

• pretty-format: Export OldPlugin type

Performance

• jest-haste-map: Reduce number of lstat calls in node crawler

Features

• babel-plugin-jest-hoist: Show codeframe on static hoisting issues

• babel-plugin-jest-hoist: Add BigInt to ALLOWED_IDENTIFIERS

• babel-preset-jest: Add @babel/plugin-syntax-bigint

• expect: Add BigInt support to toBeGreaterThan, toBeGreaterThanOrEqual, toBeLessThan and toBeLessThanOrEqual

• expect, jest-matcher-utils: Display change counts in annotation lines

• expect, jest-snapshot: Support custom inline snapshot matchers

• jest-config: Throw the full error message and stack when a Jest preset is missing a dependency

• breaking

  jest-config: Set default display name color based on runner

• jest-config: Merge preset globals with project globals

• jest-config: Support .cjs config files

• breaking

  jest-config: Support .mjs config files

• jest-core: Support reporters as default exports

• jest-core: Support --findRelatedTests paths case insensitivity on Windows

• jest-diff: Add options for colors and symbols

• breaking

  jest-diff: Export as ECMAScript module

• jest-diff: Add includeChangeCounts and rename Indicator options

• jest-diff: Add changeColor and patchColor options

• jest-diff: Add trailingSpaceFormatter option and replace cyan with commonColor

• jest-diff: Add firstOrLastEmptyLineReplacement option and export 3 diffLines functions

• jest-environment: Add optional getVmContext next to runScript (#9252 & #9428)

• jest-environment-jsdom: Add fakeTimersLolex

• jest-environment-node: Add fakeTimersLolex

• jest-environment-node: Add queueMicrotask

• jest-environment-node: Implement getVmContext (#9252 & #9428)

• @jest/fake-timers: Add Lolex as implementation of fake timers

• jest-get-type: Add BigInt support.

• jest-matcher-utils: Add BigInt support to ensureNumbers ensureActualIsNumber, ensureExpectedIsNumber

• jest-matcher-utils: Ignore highlighting matched asymmetricMatcher in diffs

• jest-reporters: Export utils for path formatting

• jest-reporters: Provides global coverage thresholds as watermarks for istanbul

• jest-runner: Warn if a worker had to be force exited

• breaking

  jest-runtime: Do not export ScriptTransformer - it can be imported from @jest/transform instead

• jest-runtime: Use JestEnvironment.getVmContext and vm.compileFunction if available to avoid the module wrapper (#9252 & #9428)

• jest-snapshot: Display change counts in annotation lines

• breaking

  jest-snapshot: Improve report when the matcher has properties

• jest-snapshot: Improve colors when snapshots are updatable

• jest-snapshot: Ignore indentation for most serialized objects

• jest-transform: Create createTranspilingRequire function for easy transpiling modules

• breaking

  jest-transform: Return transformed code as a string, do not wrap in vm.Script

• @jest/test-result: Create method to create empty TestResult

• breaking

  jest-worker: Return a promise from end(), resolving with the information whether workers exited gracefully

• jest-reporters: Transform file paths into hyperlinks

Fixes

• expect: Display expectedDiff more carefully in toBeCloseTo

• expect: Avoid incorrect difference for subset when toMatchObject fails

• expect: Consider all RegExp flags for equality

• breaking

  expect: Consider primitives different from wrappers instantiated with new

• expect: Prevent maintaining RegExp state between multiple tests

• expect: Fix subsetEquality false circular reference detection

• jest-config: Use half of the available cores when watchAll mode is enabled

• jest-config: Fix Jest multi project runner still cannot handle exactly one project

• jest-console: Add missing console.group calls to NullConsole

• jest-core: Don't include unref'd timers in --detectOpenHandles results

• jest-core: Limit number of workers when creating haste maps in projects

• jest-diff: Do not inverse format if line consists of one change

• jest-diff: Rename some new options and change their default values

• jest-environment-node: Fix TextEncoder.encode not referencing same global Uint8Array constructor

• jest-fake-timers: getTimerCount will not include cancelled immediates

• jest-fake-timers: Support util.promisify on setTimeout

• jest-jasmine2, jest-circus: Improve error message format for Node's assert.fail

• breaking

  jest-leak-detector: Use weak-napi instead of weak package

• jest-mock: Fix for mockReturnValue overriding mockImplementationOnce

• jest-reporters: Make node-notifier an optional dependency

• jest-reporters: Make all arguments to methods on BaseReporter optional

• : Set MODULE_NOT_FOUND as error code when module is not resolved from paths

• jest-resolve-dependencies: Handle dynamic dependencies correctly even when using module maps

• jest-snapshot: Remove only the added newlines in multiline snapshots

• jest-snapshot: Distinguish empty string from external snapshot not written

• breaking

  jest-snapshot: Distinguish empty string from internal snapshot not written

• breaking

  jest-snapshot: Remove report method and throw matcher errors

• jest-snapshot: Omit irrelevant received properties when property matchers fail

• jest-transform: Properly cache transformed files across tests

• jest-transform: Don't fail the test suite when a generated source map is invalid

• breaking

  jest-types: Use less null | undefined in config types

• jest-util: Allow querying process.domain

• pretty-format: Correctly detect memoized elements

• pretty-format: Fix pretty-format to respect displayName on forwardRef

Chore & Maintenance

• breaking

  *: Drop support for Node 6

• breaking

  *: Upgrade to Micromatch v4

• breaking

  babel-plugin-jest-hoist: Use ESM exports

• breaking

  jest: Use ESM exports

• breaking

  jest-cli: Use ESM exports

• breaking

  jest-cli: Remove re-exports from @jest/core

• breaking

  jest-environment-jsdom: Upgrade JSDOM from v11 to v15

• breaking

  jest-reporters: Upgrade Istanbul dependencies, which are used for code coverage

• breaking

  jest-util: Remove deprecated exports

• breaking

  jest-validate: Use ESM exports

Features

• expect: Highlight substring differences when matcher fails, part 1

• expect: Highlight substring differences when matcher fails, part 2

• expect: Improve report when mock-spy matcher fails, part 1

• expect: Improve report when mock-spy matcher fails, part 2

• expect: Improve report when mock-spy matcher fails, part 3

• expect: Improve report when mock-spy matcher fails, part 4

• expect: Throw matcher error when received cannot be jasmine spy

• expect: Improve report when negative CalledWith assertion fails

• expect: Improve report when positive CalledWith assertion fails

• expect: Display equal values for ReturnedWith similar to CalledWith

• expect, jest-snapshot: Change color from green for some args in matcher hints

• jest-snapshot: Highlight substring differences when matcher fails, part 3

• jest-core: Improve report when snapshots are obsolete

• jest-cli: Improve chai support (with detailed output, to match jest exceptions)

• *: Manage the global timeout with --testTimeout command line argument.

• pretty-format: Render custom displayName of memoized components

• jest-validate: Allow maxWorkers as part of the jest.config.js

• jest-runtime: Allow passing configuration objects to transformers

• @jest/core, @jest/test-sequencer: Support async sort in custom testSequencer

• jest-runtime, @jest/fake-timers: Add jest.advanceTimersToNextTimer

• @jest-transform: Extract transforming require logic within jest-core into @jest-transform

• jest-matcher-utils: Add color options to matcherHint

• jest-circus/jest-jasmine2: Give clearer output for Node assert errors

• jest-runner: Export all types in the type signature of jest-runner

Fixes

• jest-cli: Detect side-effect only imports when running --onlyChanged or --changedSince

• jest-cli: Allow --maxWorkers to work with % input again

• babel-plugin-jest-hoist: Expand list of whitelisted globals in global mocks

• jest-core: Make watch plugin initialization errors look nice

• jest-snapshot: Prevent inline snapshots from drifting when inline snapshots are updated

• jest-haste-map: Don't throw on missing mapper in Node crawler

• jest-core: Fix incorrect passWithNoTests warning

• jest-snapshots: Fix test retries that contain snapshots

• jest-mock: Fix incorrect assignments when restoring mocks in instances where they originally didn't exist

• expect: Fix stack overflow when matching objects with circular references

• jest-haste-map: Workaround a node >=12.5.0 bug that causes the process not to exit after tests have completed and cancerous memory growth

Performance

• jest-watcher: Minor optimization for JestHook

• @jest/reporters: Prevent runaway CPU useage with --notify on macOS

Features

• jest-circus: Bind to Circus events via an optional event handler on any custom env

• expect: Improve report when matcher fails, part 15

• jest-cli: Update --forceExit and "did not exit for one second" message colors

• expect: Improve report when matcher fails, part 16

• jest-runner: Pass docblock pragmas to TestEnvironment constructor

• expect: Improve report when matcher fails, part 17

• expect: Improve report when matcher fails, part 18

• expect: Improve report when matcher fails, part 19

Fixes

• jest-each: Fix bug with placeholder values

• jest-snapshot: Inline snapshots: do not indent empty lines

• @jest/runtime, @jest/transform: Allow custom transforms for JSON dependencies

• jest-core: Make detectOpenHandles imply runInBand

• jest-haste-map: Fix the mapper option which was incorrectly ignored

• jest-jasmine2: Fix describe return value warning being shown if the describe function throws

• jest-environment-jsdom: Re-declare global prototype of JSDOMEnvironment

• jest-snapshot: Handle arrays when merging snapshots

• expect: Extract names of async and generator functions

• jest-runtime: Fix virtual mocks not being unmockable after previously being mocked

• jest-transform: Replace special characters in transform cache filenames to support Windows

• jest-config: Allow exactly one project

Performance

• jest-runtime: Fix module registry memory leak

• jest-resolve: Optimize resolve module path

• jest-resolve: Cache current directory

• jest-get-type: Simplify checking for primitive

Features

• @jest/core, @jest/test-sequencer: Move testSequencer to individual package @jest/test-sequencer

• @jest/core, jest-cli, jest-config: Add option testSequencer allow user use custom sequencer.

Fixes

• expect: Add negative equality tests for iterables

• jest-haste-map: Resolve fs watcher EMFILE error

Chore & Maintenance

• removed

  expect: Remove repetition of matcherName and options in matchers

Features

• : Improve report when matcher fails, part 13

• @jest/core: Filter API pre-filter setup hook

• jest-snapshot: Improve report when matcher fails, part 14

• @jest/reporter: Display todo and skip test descriptions when verbose is true

• jest-runner: Support default exports for test environments

• pretty-format: Support React.Suspense

• jest-snapshot: Indent inline snapshots

• jest-config: Support colors in displayName configuration

Fixes

• jest-circus: Fix test retries with beforeAll/beforeEach failures

• expect: Fix circular references in iterable equality

• jest-changed-files: Change method of obtaining git root

• jest-each: Fix test function type

• jest-fake-timers: getTimerCount not taking immediates and ticks into account

• jest-runtime: Allow json file as manual mock

• pretty-format: Print BigInt as a readable number instead of {}

• jest-core: Fix ability to transform dependencies required from globalSetup script

• @jest/reporters: Fix Cannot read property converageData of null

• jest-worker: JEST_WORKER_ID starts at 1

• jest-config: Use default cwd even if config contains a cwd property

• : Remove internal peer dependencies

• : Remove internal peer dependencies

• : Remove internal peer dependencies

• jest-resolve: Fix requireActual with moduleNameMapper

• jest-haste-map: Fix haste map duplicate detection in watch mode

Performance

• jest-haste-map: Optimize haste map data structure for serialization/deserialization

• jest-haste-map: Avoid persisting haste map or processing files when not changed

• jest-core: Improve performance of SearchSource.findMatchingTests by 15%

• jest-resolve: Optimize internal cache lookup performance

• jest-core: Dramatically improve watch mode performance

• jest-transform: Cache regular expression instead of creating anew for every file in ScriptTransformer

• jest-core: Fix memory leak of source map info and minor performance improvements

• jest-console: Fix memory leak by releasing console output reference when printed to stdout

• jest-runtime: Use Map instead of Object for module registry

Features

• jest-haste-map: Expose throwOnModuleCollision via config.haste

We skipped 24.2.0 because a draft was accidentally published. Please use 24.3.0 or a newer version instead.

Features

• : Improve report when matcher fails, part 10

• : Improve report when matcher fails, part 11

• : Improve report when matcher fails, part 12

• : Improve report when matcher fails, part 7

• : Improve report when matcher fails, part 8

• : Improve report when matcher fails, part 9

• jest-circus/jest-jasmine2: Warn if describe returns a value

• jest-config: Print error information on preset normalization error

• jest-get-type: Add isPrimitive function

• jest-haste-map: Add skipPackageJson option

• jest-util: Add isPromise

• pretty-format: Support React.memo

Fixes

• expect: Fix toStrictEqual not considering arrays with objects having undefined values correctly

• expect: Fix custom async matcher stack trace

• expect: Fix non-object received value in toHaveProperty (#7986, #8067)

• expect: Fix non-symmetric equal for Number

• removed

  expect: Remove duck typing and obsolete browser support code when comparing DOM nodes and use DOM-Level-3 API instead

• jest-changed-files: Fix getChangedFilesFromRoots to not return parts of the commit messages as if they were files, when the commit messages contained multiple paragraphs

• jest-changed-files: Fix pattern for HG changed files

• jest-changed-files: Improve default file selection for Mercurial repos

• jest-circus: Fix bug with test.only

• : Throw explicit error when errors happen after test is considered complete

• security

  jest-cli: Fix prototype pollution vulnerability in dependency

• jest-cli: Refactor -o and --coverage combined

• jest-environment-node: Add missing globals: TextEncoder and TextDecoder

• jest-haste-map: Enforce uniqueness in names (mocks and haste ids)

• : Throw explicit error when errors happen after test is considered complete

• jest-mock: Adds a type check to prototype to allow mocks of objects with a primitive prototype property.

• jest-transform: Normalize config and remove unnecessary checks, convert TestUtils.js to TypeScript

• Make sure to not fail if unable to assign toStringTag to the process object, which is read only in Node 12

• jest-validate: Fix validating async functions

• jest-worker: Fix jest-worker when using pre-allocated jobs

• static: Remove console log '-' on the front page

Performance

• jest-haste-map: Optimize haste map tracking of deleted files with Watchman.

Features

• breaking

  jest-each: Add primitive pretty printing for interpolated titles

• jest-runtime: Add jest.isolateModules for scoped module initialization

• breaking

  jest-diff: Support diffing numbers and booleans instead of returning null for different ones

• breaking

  jest-diff: Replace diff with diff-sequences package

• breaking

  jest-cli: Only set error process error codes when they are non-zero

• breaking

  jest-config: Deprecate setupTestFrameworkScriptFile in favor of new setupFilesAfterEnv

• breaking

  jest-worker: Add functionality to call a setup method in the worker before the first call and a teardown method when ending the farm

• breaking

  jest-config: Set default notifyMode to failure-change

• breaking

  jest-haste-map: Remove support for @providesModule

• breaking

  jest-haste-map: Replace internal data structures to improve performance

• breaking

  jest-haste-map: Use relative paths to allow remote caching

• breaking

  jest-haste-map: Remove name from hash in HasteMap.getCacheFilePath

• breaking

  babel-preset-jest: Export a function instead of an object for Babel 7 compatibility

• breaking

  jest-haste-map: Expose relative paths when getting the file iterator

• breaking

  jest-cli: Run code transforms over global{Setup,Teardown}

• jest-haste-map: Add hasteFS.getSize(path)

• jest-cli: Print version ending in -dev when running a local Jest clone

• jest-cli: Add Support for globalSetup and globalTeardown in projects

• jest-runtime: Add extraGlobals to config to load extra global variables into the execution vm

• jest-util: Export specialChars containing Unicode characters and ANSI escapes for console output

• jest-config: Handle typescript (ts and tsx) by default

• jest-validate: Add support for comments in package.json using a "//" key

• jest-config: Add shorthand for watch plugins and runners

• jest-jasmine2/jest-circus/jest-cli: Add test.todo

• pretty-format: Option to not escape strings in diff messages

• jest-haste-map: Add getFileIterator to HasteFS for faster file iteration

• jest-config: Add readConfigs function, previously in jest-cli

• jest-snapshot: Enable configurable snapshot paths

• pretty-format: Support HTMLCollection and NodeList in DOMCollection plugin

• jest-runtime: Pass the normalized configuration to script transformers

• expect: Improve report when assertion fails, part 3

• jest-runtime: If require fails without a file extension, print all files that match with one

• jest-haste-map: Make ignorePattern optional

• jest-haste-map: Add getCacheFilePath to get the path to the cache file for a HasteMap instance

• jest-runtime: Remove cacheDirectory from ignorePattern for HasteMap if not necessary

• jest-validate: Add syntax to validate multiple permitted types

• jest-config: Accept an array as as well as a string for testRegex ([#7209]#7209))

• expect/jest-matcher-utils: Improve report when assertion fails, part 4

• expect/jest-matcher-utils: Improve report when assertion fails, part 5

• expect: Check constructor equality in .toStrictEqual()

• jest-util: Add jest.getTimerCount() to get the count of scheduled fake timers

• jest-config: Add dependencyExtractor option to use a custom module to extract dependencies from files (#7313, #7349, #7350, #7362)

• jest-haste-map: Accept a getCacheKey method in hasteImplModulePath modules to reset the cache when the logic changes

• jest-config: Add haste.computeSha1 option to compute the sha-1 of the files in the haste map

• expect: expect(Infinity).toBeCloseTo(Infinity) Treats Infinity as equal in toBeCloseTo matcher

• jest-worker: Add node worker-thread support to jest-worker

• jest-config: Allow bail setting to be configured with a number allowing tests to abort after n of failures

• jest-config: Allow % based configuration of --max-workers

• jest-runner: Instantiate the test environment class with the current testPath

• jest-config: Always resolve jest-environment-jsdom from jest-config

• expect: Improve report when assertion fails, part 6

• jest-worker: Add enableWorkerThreads option to explicitly opt-in to worker_threads if available

Fixes

• expect: Accept inherited properties in toHaveProperty matcher

• jest-diff: Do not claim that -0 and 0 have no visual difference

• jest-mock: Fix automock for numeric function names

• jest-config: Ensure existsSync is only called with a string parameter

• expect: toStrictEqual considers sparseness of arrays.

• jest-cli: Fix empty coverage data for untested files

• breaking

  jest-cli: Do not use text-summary coverage reporter by default if other reporters are configured

• breaking

  jest-mock: Fix bugs with mock/spy result tracking of recursive functions

• breaking

  jest-haste-map: Recover files correctly after haste name collisions are fixed

• breaking

  pretty-format: Omit non-enumerable symbol properties

• breaking

  *: Upgrade to Babel 7, dropping support for Babel 6

• jest-cli: Avoid watch mode causing bad terminal behavior in some cases

• jest-runner/jest-worker: Fix missing console output in verbose mode

• expect: Standardize file naming in expect

• jest-each: Add empty array validation check

• jest-cli: Interrupt tests if interactive watch plugin key is pressed

• jest-each: Add each array validation check

• jest-haste-map: Do not visit again files with the same sha-1

• jest-jasmine2: Fix memory leak in Error objects hold by the framework

• jest-haste-map: Fixed Haste whitelist generation for scoped modules on Windows

• jest-mock: Fix inheritance of static properties and methods in mocks

• jest-mock: Fix mocking objects without Object.prototype in their prototype chain

• jest-mock: Check _isMockFunction is true rather than truthy on potential mocks

• jest-cli: Update jest-cli to show git ref in message when using changedSince

• [jest-jasmine2] Fix crash when test return Promise rejected with null

• jest-runtime: Check _isMockFunction is true rather than truthy on potential global mocks

• jest-jasmine: Show proper error message from async assert errors

• jest-jasmine2: Better error message when a describe block is empty

• jest-jasmine2: Pending calls inside async tests are reported as pending not failed

• jest-circus: Better error message when a describe block is empty

• jest-jasmine2: Add missing testLocationResults for xit and fit

• expect: Return false from asymmetric matchers if received value isn’t string

• jest-cli: Fix unhandled error when a bad revision is provided to changedSince

• jest-config: Moved dynamically assigned cwd from jest-cli to default configuration in jest-config

• jest-config: Fix getMaxWorkers on termux

• jest-runtime: Throw an explicit error if js is missing from moduleFileExtensions

• jest-runtime: Fix missing coverage when using negative glob pattern in testMatch

• *: Ensure maxWorkers is at least 1 (was 0 in some cases where there was only 1 CPU)

• jest-runtime: Fix transform cache invalidation when requiring a test file from multiple projects

• jest-changed-files: Return correctly the changed files when using lastCommit=true on Mercurial repositories

• babel-jest: Cache includes babel environment variables

• jest-config: Use strings instead of RegExp instances in normalized configuration

• jest-circus: Make sure to display real duration even if time is mocked

• expect: Improves the failing message for toStrictEqual matcher.

• expect: Improves the failing message for toEqual matcher.

• jest-resolve: Fix not being able to resolve path to mapped file with custom platform

• jest-message-util: Improve parsing of error messages for unusually formatted stack traces

• jest-runtime: Ensure error message text is not lost on errors with code frames

• jest-haste-map: Fix to resolve path that is start with words same as rootDir

• expect: Fix toMatchObject matcher when used with Object.create(null)

• jest-haste-map: Remove legacy condition for duplicate module detection

• jest-haste-map: Fix require detection with trailing commas and ignore import typeof modules

• jest-cli: Fix to set prettierPath via config file

• expect: Test more precisely for class instance getters

• jest-cli: Support dashed args

• jest-cli: Fix to run in band tests if watch mode enable when runInBand arg used

• jest-runtime: Fix mistake as test files when run coverage issue.

• jest-cli: Print info about passWithNoTests flag

• pretty-format: Omit unnecessary symbol filter for object keys

• jest-runtime: Fix requireActual on node_modules with mock present

• jest-resolve: Fix isBuiltinModule to support versions of node without module.builtinModules

• babel-jest: Set cwd to be resilient to it changing during the runtime of the tests

• jest-snapshot: Write and read snapshots from disk even if fs is mocked

• jest-config: Normalize config.cwd and config.rootDir using `realpath

• jest-environment-node: Fix buffer property is not ArrayBuffer issue.

• babel-plugin-jest-hoist: Ignore TS type annotations when looking for out-of-scope references

• jest-config: Add name to project if one does not exist to pick correct resolver

• jest-runtime: Pass watchPathIgnorePatterns to Haste instance

• jest-runtime: Resolve mock files via Haste when using require.resolve

Chore & Maintenance

• breaking

  *: Require Node.js 6+ for all packages

• breaking

  jest-util: Remove long-deprecated globals for fake timers

• breaking

  *: Upgrade to Micromatch 3

• breaking

  *: Remove regenerator-runtime injection

Performance

• jest-mock: Improve getType function performance.

Features

• jest-haste-map: Add computeDependencies flag to avoid opening files if not needed

• jest-runtime: Support require.resolve.paths

• jest-runtime: Support paths option for require.resolve

Fixes

• jest-runner: Force parallel runs for watch mode, to avoid TTY freeze

• jest-cli: Properly reprint resolver errors in watch mode

• jest-cli: Write configuration to stdout when the option was explicitly passed to Jest

• jest-cli: Fix regression on non-matching suites (6657)

• jest-runtime: Roll back micromatch version to prevent regression when matching files

Features

• jest-cli: Allow watch plugin to be configured

• jest-snapshot: Introduce toMatchInlineSnapshot and toThrowErrorMatchingInlineSnapshot matchers

Fixes

• jest-regex-util: Improve handling already escaped path separators on Windows

• jest-cli: Fix testNamePattern value with interactive snapshots

• jest-cli: Fix enter to interrupt watch mode

Features

• jest-each: Add support for keyPaths in test titles

• jest-cli: Add jest --init option that generates a basic configuration file with a short description for each option

• jest.retryTimes: Add jest.retryTimes() option that allows failed tests to be retried n-times when using jest-circus.

Fixes

• jest-cli: Add check to make sure one or more tests have run before notifying when using --notify

• jest-cli: Pass globalConfig as a parameter to globalSetup and globalTeardown functions

• jest-config: Add missing options to the defaults object

• expect: Using symbolic property names in arrays no longer causes the toEqual matcher to fail

• expect: toEqual no longer tries to compare non-enumerable symbolic properties, to be consistent with non-symbolic properties.

• jest-util: console.timeEnd now properly log elapsed time in milliseconds.

• jest-mock: Fix MockNativeMethods access in react-native jest.mock()

• jest-cli: Fix reporters for moduleName = 'default'

Features

• jest-each: Add pretty-format serialising to each titles

• jest-cli: shouldRunTestSuite watch hook now receives an object with config, testPath and duration

• jest-each: Support one dimensional array of data

• jest-watch: Create new package jest-watch to ease custom watch plugin development

• jest-circus: Make hooks in empty describe blocks error

• Add a config/CLI option errorOnDeprecated which makes calling deprecated APIs throw hepful error messages

Fixes

• jest-each: Fix pluralising missing arguments error

• jest-each: Stop test title concatenating extra args

• expect: toHaveBeenNthCalledWith/nthCalledWith gives wrong call messages if not matched

• jest-each: Make sure invalid arguments to each points back to the user's code

• expect: toMatchObject throws TypeError when a source property is null

• jest-cli: Normalize slashes in paths in CLI output on Windows

• jest-cli: Fix run beforeAll in excluded suites tests" mode.

• [jest-haste-map] Compute SHA-1s for non-tracked files when using Node crawler

Fixes

• pretty-format: Serialize inverse asymmetric matchers correctly

Features

• expect: Expose getObjectSubset, iterableEquality, and subsetEquality

• jest-snapshot: Add snapshot property matchers

• jest-config: Support jest-preset.js files within Node modules

• jest-cli: Add --detectOpenHandles flag which enables Jest to potentially track down handles keeping it open after tests are complete.

• jest-jasmine2: Add data driven testing based on jest-each

• jest-matcher-utils: Change "suggest to equal" message to be more advisory

• jest-message-util: Don't ignore messages with vendor anymore

• jest-validate: Get rid of jest-config dependency

• jest-validate: Adds option to inject deprecationEntries

• breaking

  jest-snapshot: Concatenate name of test, optional snapshot name and count

• jest-runtime: Allow for transform plugins to skip the definition process method if createTransformer method was defined.

• expect: Add stack trace for async errors

• jest-jasmine2: Add stack trace for timeouts

• jest-jasmine2: Add stack trace for thrown non-Errors

• jest-runtime: Prevent modules from marking themselves as their own parent

• jest-mock: Add support for auto-mocking generator functions

• expect: Add support for async matchers

• expect: Suggest toContainEqual

• jest-config: Export Jest's default options

• jest-editor-support: Move coverage to ProjectWorkspace.collectCoverage

• jest-editor-support: Add coverage option to runner

• jest-haste-map: Support extracting dynamic imports

• expect: Improve output format for mismatchedArgs in mock/spy calls.

• jest-cli: Add support for using --coverage in combination with watch mode, --onlyChanged, --findRelatedTests and more

• breaking

  jest-jasmine2: Adds error throwing and descriptive errors to it/ test for invalid arguments. [jest-circus] Adds error throwing and descriptive errors to it/ test for invalid arguments

• jest-matcher-utils: Add isNot option to matcherHint function

• jest-config: Add <rootDir> to runtime files not found error report

• expect: Make toThrow matcher pass only if Error object is returned from promises

• expect: Add isError to utils

• expect: Add inverse matchers (expect.not.arrayContaining, etc., #5517)

• expect: expect.extend now also extends asymmetric matchers

• jest-mock: Update spyOnProperty to support spying on the prototype chain

• jest-mock: Add tracking of return values in the mock property

• jest-mock: Add tracking of thrown errors in the mock property

• Add nthCalledWith spy matcher

• jest-cli: Add isSerial property that runners can expose to specify that they can not run in parallel

• expect: Add .toBeCalledTimes and toHaveBeenNthCalledWith aliases

• jest-cli: Interactive Snapshot Mode improvements

• jest-editor-support: Add no-color option to runner

• jest-jasmine2: Pretty-print non-Error object errors

• jest-message-util: Include column in stack frames

• expect: Introduce toStrictEqual

• expect: Add return matchers

• jest-cli: Improve snapshot summaries

• expect: Include custom mock names in error messages

• jest-diff: Support returning diff from oneline strings

• expect: Improve return matchers

• jest-cli: Overhaul watch plugin hooks names

• breaking

  jest-mock: Include tracked call results in serialized mock

Fixes

• jest-cli: Fix stdin encoding to utf8 for watch plugins.

• expect: Better detection of DOM Nodes for equality

• jest-cli: Fix misleading action description for F key when in "only failed tests" mode.

• jest-worker: Stick calls to workers before processing them

• babel-plugin-jest-hoist: Allow using console global variable

• jest-jasmine2: Always remove node core message from assert stack traces

• expect: Add stack trace when expect.assertions and expect.hasAssertions causes test failures.

• jest-runtime: Throw a more useful error when trying to require modules after the test environment is torn down

• breaking

  jest-mock: Replace timestamps with invocationCallOrder

• jest-jasmine2: Install sourcemap-support into normal runtime to catch runtime errors

• jest-jasmine2: Added assertion error handling inside afterAll hook

• jest-cli: Remove the notifier actions in case of failure when not in watch mode.

• jest-mock: Extend .toHaveBeenCalled return message with outcome

• jest-runner: Assign process.env.JEST_WORKER_ID="1" when in runInBand mode

• jest-cli: Add descriptive error message when trying to use globalSetup/globalTeardown file that doesn't export a function.

• expect: Do not rely on instanceof RegExp, since it will not work for RegExps created inside of a different VM

• jest-resolve: Update node module resolution algorithm to correctly handle symlinked paths

• jest-editor-support: Update Settings to use spawn in shell option

• jest-cli: Improve the error message when 2 projects resolve to the same config

• jest-runtime: Remove retainLines from coverage instrumentation

• jest-cli: Fix update snapshot issue when using watchAll

• expect: Fix rejects.not matcher

• jest-runtime: Prevent Babel warnings on large files

• jest-mock: Prevent mockRejectedValue from causing unhandled rejection

• pretty-format: Handle React fragments better

• pretty-format: Handle formatting of React.forwardRef and Context components

• jest-cli: Switch collectCoverageFrom back to a string

• jest-regex-util: Fix handling regex symbols in tests path on Windows

• jest-util: Fix handling of NaN/Infinity in mock timer delay

• jest-resolve: Generalise test for package main entries equivalent to ".".

• jest-config: Ensure that custom resolvers are used when resolving the configuration

• website: Fix website docs

• expect: Fix isEqual Set and Map to compare object values and keys regardless of order

• breaking

  pretty-format: Remove undefined props from React elements

• jest-haste-map: Properly resolve mocked node modules without package.json defined

Chore & Maintenance

• breaking

  babel-jest: Always return object from transformer

• breaking

  jest-runtime: Remove jest.genMockFn and jest.genMockFunction

Fixes

• jest-haste-map: Parallelize Watchman calls in crawler

• jest-editor-support: Update TypeScript definitions

• removed

  babel-jest: Remove retainLines argument to babel.

Features

• jest-runtime: Provide require.main property set to module with test suite

Fixes

• jest-haste-map: Overhauls how Watchman crawler works fixing Windows

• expect: Allow matching of Errors against plain objects

• jest-haste-map: Do not read binary files in Haste, even when instructed to do so

• jest-cli: Don't skip matchers for exact files

• jest-runtime: Align handling of testRegex on Windows between searching for tests and instrumentation checks

• jest-config: Make it possible to merge transform option with preset

• jest-util: Fix console.assert behavior in custom & buffered consoles

Features

• deprecated

  jest-runtime: Deprecate mapCoverage option.

• babel-jest: Add option to return sourcemap from the transformer separately from source.

• jest-validate: Add ability to log deprecation warnings for CLI flags.

• jest-serializer: Added new module for serializing. Works using V8 or JSON

Fixes

• expect: Add descriptive error message to CalledWith methods when missing optional arguments

• jest-cli: Fix inability to quit watch mode while debugger is still attached

• jest-haste-map: Properly handle platform-specific file deletions

Features

• jest-util: Add the following methods to the "console" implementations: assert, count, countReset, dir, dirxml, group, groupCollapsed, groupEnd, time, timeEnd

• jest-editor-support: Add watchAll flag

• jest-cli: Support multiple glob patterns for collectCoverageFrom

Fixes

• babel-jest: Revert "Remove retainLines from babel-jest"

• jest-docblock: Support multiple of the same @pragma.

Features

• jest-worker: Assign a unique id for each worker and pass it to the child process. It will be available via process.env.JEST_WORKER_ID

Features

• jest-runner: Move test summary to after coverage report

• jest-cli: Added --notifyMode to specify when to be notified.

• diff-sequences: New package compares items in two sequences to find a longest common subsequence.

• jest-matcher-utils: Add comment option to matcherHint function

• jest-config: Allow lastComit and changedFilesWithAncestor via JSON config

• jest-util: Add deletion to process.env as well

• jest-util: Add case-insensitive getters/setters to process.env

• jest-mock: Add util methods to create async functions.

Fixes

• jest-cli: Add trailing slash when checking root folder

• jest-cli: Hide interactive mode if there are no failed snapshot tests

• babel-jest: Remove retainLines from babel-jest

• jest-cli: Glob patterns ignore non-require-able files (e.g. README.md)

• jest-mock: Add backticks support (``) to mock a certain package via the __mocks__ folder.

• jest-message-util: Prevent an ENOENT crash when the test file contained a malformed source-map. (#5405).

• jest: Add import-local to jest package.

• expect: Support class instances in .toHaveProperty() and .toMatchObject matcher.

• jest-cli: Fix npm update command for snapshot summary. (#5376, 5389)

• expect: Make rejects and resolves synchronously validate its argument.

• jest-resolve: Search required modules in node_modules and then in custom paths.

• jest-resolve: Get builtin modules from node core.

• jest-resolve: Detect and preserve absolute paths in moduleDirectories. Do not generate additional (invalid) paths by prepending each ancestor of cwd to the absolute path. Additionally, this fixes functionality in Windows OS.

Features

• jest-cli: Make Jest exit without an error when no tests are found in the case of --lastCommit, --findRelatedTests, or --onlyChanged options having been passed to the CLI

• jest-cli: Add interactive snapshot mode

Fixes

• jest-cli: Use import-local to support global Jest installations.

• jest-runner: Fix memory leak in coverage reporting

• jest-cli: Fix missing newline in console message

• jest-cli: --lastCommit and --changedFilesWithAncestor now take effect even when --onlyChanged is not specified.

Fixes

• jest-leak-detector: Removed the reference to weak. Now, parent projects must install it by hand for the module to work.

• expect: Fail test when the types of stringContaining and stringMatching matchers do not match.

• jest-cli: Treat dumb terminals as noninteractive

• jest-cli: jest --onlyChanged --changedFilesWithAncestor now also works with git.

• jest-config: Fix unexpected condition to avoid infinite recursion in Windows platform.

• jest-config: Escape parentheses and other glob characters in rootDir before interpolating with testMatch.

• jest-regex-util: Fix breaking change in --testPathPattern

• expect: Do not override Error stack (with Error.captureStackTrace) for custom matchers.

• pretty-format: Pretty format for DOMStringMap and NamedNodeMap

• jest-cli: Use a better console-clearing string on Windows

Features

• jest-jasmine: Allowed classes and functions as describe names.

• jest-jasmine2: Support generator functions as specs.

• jest-jasmine2: Allow spyOn with getters and setters.

• jest-config: Allow configuration objects inside projects array

• expect: Add support to .toHaveProperty matcher to accept the keyPath argument as an array of properties/indices.

• jest-runner: Test environments are now passed a new options parameter. Currently this only has the console which is the test console that Jest will expose to tests.

• jest-environment-jsdom: Pass the options.console to a custom instance of virtualConsole so jsdom is using the same console as the test.

Fixes

• jest-cli: New line before quitting watch mode.

Features

• babel-jest: moduleFileExtensions not passed to babel transformer.