@jest/types

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.