@jest/expect

Features

• @jest/transform: Strip TypeScript types with Node when no transformer claims a .ts, .mts or .cts file

Fixes

• jest-core, jest-haste-map, jest-transform: Keep require('../package.json') external when bundling, so jest --version and the transform and haste-map cache keys report the released version instead of the previous one

• jest-each: Escape a table row's keys before building the $variable interpolation RegExp, so a column name such as count(*) no longer fails the whole table with Invalid regular expression, and a . or | in a column name is matched literally

• @jest/source-map: Resolve absolute Windows paths in a source map's sources and sourceRoot again, instead of appending them to the transformed file's directory

Fixes

• jest-config: Don't warn about global-only options in the config that supplies the global config - the root config a project resolves to, or the first entry of --projects when no root config is passed

• jest-config, jest-types: Stop accepting reporters, coverageReporters, workerIdleMemoryLimit, cwd and runnerOptions in a project config - they were silently ignored, and now warn like the other global-only options

• jest-config, jest-validate: Warn about maxWorkers and coverageThreshold in a project config instead of dropping them without a word

• jest-resolve: Match moduleNameMapper patterns against the specifier as written again (reverting #16390)

• jest-runtime: Resolve package imports specifiers like #dep under ESM again

On a personal note: King Harald V of Norway passed away this morning. He ascended the throne 35 years ago, two months before I was born. This release is dedicated to his memory. Hvil i fred 🇳🇴

This is a big release. It touches jest-runtime, jest-resolve and jest-haste-map in many places, and with this many changes there might be regressions 😬. If your suite behaves differently after upgrading, please open an issue.

Highlights

whenCalledWith

Mock functions can now configure return values per argument list, contributed by @timkindberg (#16053):

const fn = jest.fn();
fn.whenCalledWith('apple').mockReturnValue('red');
fn.whenCalledWith('banana').mockReturnValue('yellow');
fn.whenCalledWith(expect.any(Number)).mockReturnValue('numeric');

fn('apple'); // 'red'
fn('banana'); // 'yellow'
fn(42); // 'numeric'
fn('grape'); // undefined

The returned object is a real Mock, so mockReturnValueOnce, mockResolvedValue, mockImplementation etc. all chain here too. Argument slots accept literals or any asymmetric matcher, with the same equality semantics as toHaveBeenCalledWith(). Calls that match nothing fall through to the base mock. See the Mock Functions docs for matching and precedence details.

Describe-level retries

jest.retryTimes() can now retry a whole describe block instead of a single test, contributed by @soltonigiri (#16322). Each attempt reruns the block's beforeAll/afterAll hooks, child tests and nested describes, which helps when tests in a block depend on shared state:

describe('workflow', () => {
  jest.retryTimes(3, {entireDescribe: true});

  test('first step', () => {});
  test('second step', () => {}); // a failure retries the entire block
});

New file watcher

The non-watchman path of jest-haste-map is rewritten. @parcel/watcher replaces the homegrown NodeWatcher and FSEventsWatcher (#16188), and fdir replaces the hand-rolled directory recursion in the crawler (#16187). A batch of fixes also makes watching and indexing survive locked files on Windows, watchman failures, and duplicate manual mocks (#16295, #16358, #16355, #16360).

If you can, please run your suite with --no-watchman (in and out of watch mode) to exercise the new crawler and watchers, and report anything odd 👍

Long-requested dependency updates

• babel-plugin-istanbul is updated to v8

• glob is updated to v13

• source-map-support is replaced with an implementation in @jest/source-map (#16327). This fixes a memory leak where source-map-support's process-global caches pinned every finished test file's sandbox. Source maps also survive environment teardown, --testLocationInResults looks up the right column, and scheme-prefixed sources like webpack:/// are kept as-is.

Performance

• Warm module resolution costs about a third of what it did, and repeated work is gone from the resolution hot path (#16373, #16371).

• Per-require overhead in jest-runtime is cut: module ID resolution is skipped when no mock can apply, and core modules answer before the manual-mock probe (#16376).

• jest-snapshot loads babel, semver and synckit lazily, so every test process loads ~200 fewer modules (#16387).

• jest-haste-map caches the watchman socket path, so warm runs spawn no watchman processes (#16386), and reuses cached metadata for duplicated haste names instead of re-parsing them on every startup (#16351).

More new APIs

• Snapshot failures expose the .snap file path as matcherResult.snapshotPath in failureDetails (#16374).

• --collectTests expands test.each/describe.each cases and reports per-status counts plus a summary line that matches a real run (#16259).

• AggregateError inner errors and nested cause chains render with code frames and per-level indentation, and are included in --json output, retryReasons and reporter annotations (#16316).

ESM

A long list of fixes brings jest-runtime's module system closer to Node's:

• Automocking and manual __mocks__ files now apply to ESM on Node 24.9+. Static imports, dynamic import() and require() of an ESM file generate an automock from the real module's namespace instead of failing with "Attempting to import a mock without a factory" (#16391).

• Many jest.unstable_mockModule gaps are closed: mocks apply when the mocked file is require()d directly, async factories run once and fail the import instead of crashing the worker 😅, and mocks made inside jest.isolateModules stay scoped to that block (#16389, #16365).

• require(esm), CJS/ESM interop, import.meta, data: URIs and error ordering now match Node in dozens of edge cases. See the Fixes section for the full list (#16364 through #16391).

• The module-sync export condition resolves, so packages that expose their ESM entry point for require() load the same file Node picks (#16336).

The intentional divergences from Node's module system are now documented on the ECMAScript Modules page (#16368).

Resolver

• The default resolver honors Node's --preserve-symlinks / NODE_PRESERVE_SYMLINKS (#16260).

• moduleNameMapper applies to both spellings of core module specifiers (fs and node:fs), and builtins that only exist prefixed (node:sqlite, node:test) resolve asynchronously (#16390, #16388).

• A user resolver can be written as an ES module (#16332).

On top of the highlights there are ~60 fixes across jest-circus, jest-haste-map, jest-config, jest-mock and the transform cache keys. See the full changelog below 😀

Features

• @jest/expect-utils, jest-mock: Add mockFn.whenCalledWith(...args) for configuring return values per argument list, with first-class asymmetric-matcher support

• @jest/expect-utils: Export AsymmetricMatcher and FunctionParameters types (previously private to expect)

• [jest-circus, jest-core, jest-jasmine2, jest-test-result, jest-types] --collectTests now expands test.each/describe.each cases and reports per-status counts (skipped/todo via the new wouldRun flag for selected tests) plus a summary line that match a real run, including under --testNamePattern and .only/fdescribe focus on both the circus and jasmine2 runners

• [jest-circus, jest-environment, jest-runtime, jest-types] Add describe-level retries via jest.retryTimes(..., {entireDescribe: true})

• [jest-circus, jest-message-util, jest-reporters, jest-types] Add retryMessages to AssertionResult and export formatErrorStack, so the retry log renders nested cause and AggregateError sections with code frames instead of serialized [cause]:/[errors]: markers

• jest-circus, jest-types: Add unhandledErrorsDetailed to Circus.RunResult, so an unhandled rejection reports its cause chain and AggregateError entries with code frames instead of a pre-serialized stack

• jest-haste-map: Replace NodeWatcher and FSEventsWatcher with @parcel/watcher for the non-watchman watch path

• jest-resolve: Bump unrs-resolver to 1.12.1, remove jest-pnp-resolver and unnecessary checks

• jest-resolve: Honor Node's --preserve-symlinks / NODE_PRESERVE_SYMLINKS in the default resolver by passing symlinks: false to unrs-resolver

• jest-runtime: Apply automocking and manual __mocks__ files to synchronously evaluable ESM graphs on Node 24.9+ - static imports, dynamic import() and require() of an ESM file now generate an automock from the real module's namespace instead of failing with "Attempting to import a mock without a factory". Graphs that need async evaluation (top-level await) or an async-only resolver or transformer still throw

• jest-runtime: Route process.getBuiltinModule through the sandbox, so it returns the sandbox process and the hooked node:module instead of the host's

• jest-runtime: Throw an actionable error from module.register() and module.registerHooks() inside a test - the hooks attached to the loader running Jest itself, never saw the sandboxed requires they were meant for, and stayed registered for every later test file in the worker

• jest-runtime: Surface resolution and import-attribute errors in an ESM graph before executing any of its CJS dependencies on Node 24.9+, matching Node's run-nothing-on-a-broken-graph behavior; the legacy loader on older versions keeps its linking-time execution order

• jest-runtime: Throw ERR_SOURCE_PHASE_NOT_DEFINED with an actionable message for import source and import.source(), instead of failing at instantiation with V8's bare "Source phase import object is not defined"

• jest-runtime: Emit the JSON-without-import-attribute deprecation warning once per test file instead of once per worker, so it is no longer silently swallowed for every file after the first

• jest-runtime: Set import.meta.main to true in the test file and false in every module it loads, matching Node 24+

• jest-runtime: Resolve the module-sync export condition, so a package that exposes its ESM entry point for require() loads the same file Node would

• jest-snapshot: Add external snapshot paths to custom reporter failure details

Fixes

• jest-console, jest-reporters: CustomConsole now buffers console output so TestResult.console is populated for reporters when verbose is enabled, while GitHubActionsReporter avoids replaying buffered output in verbose mode

• [expect, jest-message-util, jest-pattern, jest-regex-util, jest-util] Revert node: protocol imports to restore webpack/browser-bundle compatibility

• expect: Widen toMatchObject and objectContaining parameter type from Record<string, unknown> to object so class instances are accepted

• jest-circus: Call a generator test body with the shared test context, so this matches what a regular test function receives

• jest-circus: Capture the error listeners of the parent process instead of the in-sandbox process, so listeners registered before the test file survive teardown and sandbox listeners no longer leak onto the parent

• jest-circus: Clear currentlyRunningTest after skipped and todo tests

• jest-circus: Prevent late done() callbacks from affecting later test or hook invocations

• jest-circus, jest-jasmine2: Honor --expand when formatting node:assert failures, instead of always collapsing the diff

• jest-circus, jest-jasmine2, jest-message-util: Serialize the inner errors of an AggregateError into failureMessages, retryReasons and unhandledErrors, so --json output and reporter annotations include them

• jest-circus, jest-snapshot: Keep snapshot state and counts correct when a test retries

• @jest/create-cache-key-function: Include the caller support flags in the generated key, so a transformer that emits ESM or CJS based on them no longer shares one cache entry between the two

• @jest/create-cache-key-function: Include the stringified project config in the generated key, so editing a transformer's own settings invalidates what it cached

• @jest/transform: Include the caller support flags in a transform's cache key, so a file transformed both as ESM and as CJS no longer serves one shape's output for the other

• jest-config: Add missing findRelatedTests, outputFile, and replname entries to ValidConfig so they no longer trigger spurious "Unknown option" warnings

• jest-config: Use --config for the global config when multiple --projects are specified

• jest-core: Serialize bigint values in --json and --outputFile output as their literal form (4n), instead of failing the run with TypeError: Do not know how to serialize a BigInt

• jest-core: Do not report a CustomGC async resource (used by N-API addons such as napi-rs for per-isolate GC bookkeeping) as an open handle, since it is napi_unref'd by the addon and can never keep the event loop alive

• jest-each: Keep a $&, $`, $' or $$ inside a %p param value out of the replacement, so the title shows the value instead of the text around it

• jest-each: Interpolate a bigint into a %j title as its literal form ("4n") at any depth, instead of throwing TypeError: Do not know how to serialize a BigInt while collecting the tests

• jest-environment, jest-runtime: Bind sandboxInjectedGlobals to the right values when injectGlobals is false, instead of shifting every one of them by a position

• jest-environment-node, jest-util: Only warn about a conflicting globalsCleanup mode when one was explicitly configured, and follow the mode that is actually in effect

• jest-environment-node, jest-util: Stop resolving lazy globals when setting up an environment, so Node 26's builtin module globals are no longer loaded (and no longer emit their deprecation warnings) for every test file

• jest-haste-map: Keep watch mode alive when an outside process briefly makes a file unreadable on Windows, instead of tearing the watcher down on EPERM

• jest-haste-map: Keep indexing when an outside process holds a file open on Windows, instead of failing the whole crawl on EPERM

• jest-haste-map: Keep a duplicated manual mock resolving when the file it pointed at is deleted in watch mode

• jest-haste-map: Shut the worker farm down when a duplicate manual mock aborts the build under throwOnModuleCollision

• jest-haste-map: Attach the watchman client's error listener before the first command, so a watchman failure falls back to the node crawler instead of crashing on an unhandled error event, and always end the client

• jest-haste-map: Stop delivering watch events after WatchmanWatcher is closed, and route its warnings through the configured console

• jest-haste-map: Restore the nested duplicates index correctly in ModuleMap.fromJSON, so a haste collision reported inside a test worker raises DuplicateHasteCandidatesError instead of a TypeError

• breaking

  jest-haste-map: Match watched files on a full extension, so moduleFileExtensions: ['js'] no longer accepts foo.mjs

• jest-haste-map: Delimit the fields that make up the haste map cache key, so two different option sets cannot hash to the same cache file

• jest-message-util: Print the inner errors of an AggregateError thrown inside a test

• jest-message-util: Indent nested cause and AggregateError sections of a test failure by one level per depth, so the nesting is legible instead of rendering flat

• jest-message-util: Color stack traces line by line so blank lines stay blank

• jest-message-util: Detect Jest's own frames without assuming the checkout directory's name, and cover @jest/* packages, so stack traces and code frames point at user code

• jest-mock: mockResolvedValue / mockRejectedValue now see all overload return types, so a Promise-returning overload survives even when a later overload returns a non-Promise (e.g. pg.Client['end'])

• @jest-environment/jsdom-abstract: Make @types/jsdom a peer dependency

• jest-mock: Remove the leftover own accessor descriptor when restoring a spyOn of an inherited getter or setter, so the instance keeps reflecting the prototype

• jest-resolve: Include extensionsToTreatAsEsm in the shouldLoadAsEsm cache key, so projects with different extension lists don't read each other's answers

• jest-resolve: Make getModuleIDAsync build and cache data: URI module IDs the same way as getModuleID

• jest-resolve: Keep the node: prefix when resolving a core module asynchronously, so a builtin that only exists prefixed (node:sea, node:sqlite, node:test, node:test/reporters) resolves instead of failing as a missing bare package

• jest-resolve: Look up manual mocks for node: protocol specifiers under the unprefixed name they are stored as

• jest-resolve: Apply moduleNameMapper consistently to both spellings of core module specifiers (fs vs node:fs)

• jest-resolve: Keep virtual and ordinary mock module IDs isolated across test files

• jest-resolve: Guard missing require.resolve.paths

• jest-resolve, jest-config, jest-runner: Support a user resolver written as an ES module

• jest-resolve, jest-runtime: Throw the CJS parse error for ESM syntax in a "type": "commonjs" package or a .cjs file instead of loading it as ESM, matching Node

• @jest/source-map: Keep source map sources that name a scheme, such as webpack:///, instead of resolving them into a path that does not exist

• @jest/source-map: Look up --testLocationInResults positions at the right column, and keep a mapping to the first column instead of discarding it

• @jest/source-map: Warn when a source map cannot be parsed, instead of silently leaving its frames untranslated

• jest-runner, @jest/source-map: Keep a source-mapped stack for an error thrown after the test environment was torn down

• jest-runtime, @jest/source-map: Keep source maps past teardown and past the next test file's install, so a stack from a file no earlier stack mentioned still points at the original source

• jest-runtime: Report that no coverage was collected when getAllV8CoverageInfoCopy is called after teardown, instead of returning an empty result

• jest-runtime: Cache a CJS module's parsed exports before walking its re-exports, so two modules that re-export each other no longer overflow the stack when imported from ESM

• jest-runtime: Keep a re-exported ES module's parse failure from marking the re-exporting CommonJS file as ESM, so module.exports = require('./dep.mjs') loads instead of failing with module is not defined

• jest-runtime: Scope module mocks instantiated inside jest.isolateModules/isolateModulesAsync to that block, so a mock first imported there no longer outlives it - matching how CommonJS mocks already behave

• jest-runtime: Suspend module isolation while generating an automock, so loading the real module to read its shape no longer populates the isolated registry

• jest-runtime: Check a cached ES module's status before require() returns it, so a module whose evaluation threw rethrows that error and one left linked by a failed sibling is evaluated instead of returning uninitialized bindings

• jest-runtime: Report the original ERR_REQUIRE_ASYNC_MODULE when a require() of a top-level-await graph is retried, instead of a spurious "concurrent import()" error

• jest-runtime: Throw the evaluation error when another caller's import() of the same module failed while we awaited it, instead of resolving with the errored module

• jest-runtime: Mark the result of require()ing an ES module that has a default export with __esModule: true through a live-binding facade, and serve the same object from require.cache, matching Node

• jest-runtime: Provide a CommonJS module's exports under the 'module.exports' named export when imported from ESM, matching Node 23+

• jest-runtime: Give the test file itself a non-null require.main

• jest-runtime: Populate module.children with the modules a file loads, matching Node

• jest-runtime: Provide import.meta.resolve and import.meta.jest in data: URI modules, accept any-case mediatype parameters, and use Node's error codes for invalid data: URIs

• jest-runtime: Key ES modules by full URL, so query and fragment suffixes create the same module instances as Node and show up in import.meta.url

• jest-runtime: Share modules between overlapping graphs when a CommonJS module require()s an ES module mid-load, instead of evaluating shared dependencies twice

• jest-runtime: Throw ERR_REQUIRE_CYCLE_MODULE like Node when a CommonJS module require()s an ES module that is still being loaded, instead of evaluating the module a second time

• jest-runtime: Key builtin modules in the ESM registry by one canonical specifier

• jest-runtime: import.meta.resolve() for a builtin uses its node: specifier

• jest-runtime: Fall back to native ESM when a .js file contains ESM syntax but has no "type":"module" marker

• jest-runtime: Allow require() of ESM-marked files on Node < 24.9 via transform fallback

• jest-runtime, @jest/transform: Surface actionable ERR_REQUIRE_ESM error for files with untransformed ESM syntax instead of the generic "unexpected token" message

• jest-runtime: Support older test environments whose moduleMocker does not implement clearMocksOnScope

• jest-runtime: Apply jest.unstable_mockModule when the mocked file itself is require()d, not only when it is imported as a dependency

• jest-runtime: Apply jest.unstable_mockModule to statically imported data: URIs on Node 24.9+, matching dynamic import()

• jest-runtime: Run an async jest.unstable_mockModule factory once per module instead of twice, and fail the import instead of crashing the worker when the factory rejects

• jest-runtime: Hide a require(esm) module that failed to evaluate from require.cache, as Node does, instead of exposing a namespace with uninitialized bindings

• jest-runtime: Strip the byte-order mark when importing a JSON module, matching require() and Node

• jest-runtime: Throw ERR_REQUIRE_ASYNC_MODULE when require(esm) runs under an async-only custom resolver, instead of silently resolving with the default resolver

• jest-runtime: Parse imported JSON modules with the test realm's JSON, so their objects pass instanceof Object inside the test like require()d JSON does

• jest-runtime: Accept every file: URL string in the sandboxed module.createRequire, including one with a localhost authority, as Node does

• jest-runtime: Point at {virtual: true} when jest.mock or jest.unstable_mockModule is given a module that cannot be resolved

• jest-reporters: Fix coverage report table formatting in CI/GitHub Actions environments where process.stdout.columns is undefined by falling back to the COLUMNS env var or 80 columns in CI, preserving existing behaviour in other non-TTY environments

• jest-runtime: Support CJS-in-ESM exports via "module.exports" named exports

• jest-snapshot: Keep a skipped or failed test's hinted snapshots, instead of reporting them obsolete

• jest-util: Stop globsToMatcher reusing a cached matcher compiled with different picomatch options, and keep its dot: true default when dot is passed as undefined

• pretty-format: Move the react-is aliases into the @jest scope, so they cannot be shadowed by unrelated packages published under the alias names

Chore & Maintenance

• deprecated

  @jest/source-map: Deprecate getCallsite in favour of SourceMapSupport#getCallsite

Big release! 😀

Main feature is a rewrite of our custom runtime in preparation for stabilisation of native support of ESM. As part of that work require(esm) module is now supported on Node 24.9+ (still requires --experimental-vm-modules like before).

In addition we now support fake timers for the recently released Temporal API in Node v26.

React 19 is also supported properly in pretty-format, meaning snapshots of React components now work like they should.

Due to all the changes, there might be regressions that snuck in. Please report them!

Full list of changes below

Features

• babel-jest: Support collecting coverage from .mts, .cts (and other) files

• [jest-circus, jest-cli, jest-config, jest-core, jest-jasmine2, jest-types] Add --collect-tests flag to discover and list tests without executing them

• jest-config, jest-runner, jest-worker: Add workerGracefulExitTimeout config option to control how long workers are given to exit before being force-killed

• jest-config: Add support for jest.config.mts as a valid configuration file

• [jest-config, jest-core, jest-reporters, jest-runner] verbose and silent can now be set per-project; the project-level value overrides the global value for that project's tests

• @jest/fake-timers: Accept Temporal.Duration in jest.advanceTimersByTime() and jest.advanceTimersByTimeAsync()

• @jest/fake-timers: Accept Temporal.Instant and Temporal.ZonedDateTime in jest.setSystemTime() and useFakeTimers({now})

• @jest/fake-timers: Support faking Temporal.Now.*

• jest-mock: Add clearMocksOnScope(scope) on ModuleMocker for clearing every mock function exposed on a scope object

• jest-resolve: Add canResolveSync() on Resolver so callers can detect when a user-configured resolver only exports an async hook

• jest-runtime: Use synchronous evaluate() for ES modules without top-level await on Node versions that support it (v24.9+), and prefer the synchronous transform path when a sync transformer is configured

• jest-runtime: Support require() of ES modules on Node v24.9+

• jest-runtime: Validate TC39 import attributes (with { type: 'json' }) on ESM imports

• @jest/transform: Add canTransformSync(filename) on ScriptTransformer so callers can pick the sync vs async transform path

• jest-util: Add isError helper

• pretty-format: Support React 19

Fixes

• expect-utils: Fix toStrictEqual failing on structuredClone results due to cross-realm constructor mismatch

• @jest/expect-utils: Prevent toMatchObject/subset matching from throwing when encountering exotic iterables

• fake-timers: Convert Date to milliseconds before passing to @sinonjs/fake-timers

• jest: Export GlobalConfig and ProjectConfig TypeScript types

• jest-circus: Prevent crash when asyncError is undefined for non-Error throws

• jest-circus, jest-jasmine2: Include Error.cause in JSON failureMessages output

• jest-config: Fix preset path resolution on Windows when the preset uses subpath exports

• jest-config: Allow collectCoverage and coverageProvider in project config without a validation warning

• jest-config: Project config validator now emits "is not supported in an individual project configuration" instead of "probably a typing mistake" for known global-only options

• jest-environment-node: Fix --localstorage-file warning on Node 25+

• jest-reporters: Apply global coverage threshold to unmatched pattern files in addition to glob/path thresholds

• [jest-reporters, jest-runner, jest-runtime, jest-transform] Fix coverage report not showing correct code coverage when using projects config option

• jest-runtime: Resolve expect and @jest/expect from the internal module registry so test-file imports share the same JestAssertionError as the global expect

• jest-runtime: Improve CJS-from-ESM interop: __esModule/Babel default unwrap, broader named-export coverage, and shared CJS singleton across importers

• jest-runtime: Load .js files with ESM syntax but no "type":"module" marker as native ESM

• jest-runtime: Extend the .js-with-ESM-syntax fallback to require() on Node v24.9+ - falls back to require(esm) when the CJS parser rejects ESM syntax

• jest-runtime: Fix deadlocks and double-evaluation in concurrent ESM and wasm imports

• jest-runtime: Fix error when require() is called after the Jest environment has been torn down

• jest-runtime: Fix missing error when import() is called after the Jest environment has been torn down

• jest-runtime: Fix virtual unstable_mockModule registrations not respected in ESM

• jest-runtime: Apply moduleNameMapper when resolving modules with require.resolve() and the paths option

Features

• jest-config: Add defineConfig and mergeConfig helpers for type-safe Jest config

• jest-fake-timers: Add setTimerTickMode to configure how timers advance

• *: Reduce token usage when run through LLMs

Fixes

• jest-config: Keep CLI coverage output when using --json with --outputFile

• jest-mock: Use Symbol from test environment

• jest-reporters: Fix issue where console output not displayed for GHA reporter even with silent: false option

• jest-runtime: Fix issue where user cannot utilize dynamic import despite specifying --experimental-vm-modules Node option

• jest-test-sequencer: Fix issue where failed tests due to compilation errors not getting re-executed even with --onlyFailures CLI option

• jest-util: Make sure process.features.require_module is false

Features

• jest-environment-jsdom-abstract: Add support for JSDOM v27

Fixes

• babel-jest: Export the TransformerConfig interface

• jest-config: Fix jest.config.ts with TS loader specified in docblock pragma

Features

• jest-leak-detector: Configurable GC aggressiveness regarding to V8 heap snapshot generation

• jest-runtime: Reduce redundant ReferenceError messages

• jest-core: Include test modules that failed to load when --onlyFailures is active

Fixes

• Fix deprecated goo.gl snapshot guide link not getting replaced with fully canonical URL

• jest-circus: Fix it.concurrent not working with describe.skip

• jest-snapshot: Fix mangled inline snapshot updates when used with Prettier 3 and CRLF line endings

• jest-runtime: Importing from @jest/globals in more than one file no longer breaks relative paths

Features

• expect: The Inverse type is now exported

• expect: Support async functions in toBe

Fixes

• jest: Jest --onlyFailures --listTests now correctly lists only failed tests

• jest-snapshot: Handle line endings in snapshots

What's Changed

Features

• jest-resolver: Implement the defaultAsyncResolver

Fixes

• jest-resolver: Resolve builtin modules correctly

• jest-environment-node, jest-util: Avoid setting globals cleanup protection symbol when feature is off

Chore & Maintenance

• deprecated

  *: Remove and deprecate jest-repl package

Today we are happy to announce the release of Jest 30. This release features a substantial number of changes, fixes, and improvements. While it is one of the largest major releases of Jest ever, we admit that three years for a major release is too long. In the future, we are aiming to make more frequent major releases to keep Jest great for the next decade.

If you want to skip all the news and just get going, run npm install jest@^30.0.0 and follow the migration guide: Upgrading from Jest 29 to 30.

Read the full blog post

Features

• *: Renamed globalsCleanupMode to globalsCleanup and --waitNextEventLoopTurnForUnhandledRejectionEvents to --waitForUnhandledRejections

• expect: Add ArrayOf asymmetric matcher for validating array elements.

• babel-jest: Add option excludeJestPreset to allow opting out of babel-preset-jest

• expect: Revert #15038 to fix expect(fn).toHaveBeenCalledWith(expect.objectContaining(...)) when there are multiple calls

• jest-circus, jest-cli, jest-config: Add waitNextEventLoopTurnForUnhandledRejectionEvents flag to minimise performance impact of correct detection of unhandled promise rejections introduced

• jest-circus: Add a waitBeforeRetry option to jest.retryTimes

• jest-circus: Add a retryImmediately option to jest.retryTimes

• jest-circus, jest-jasmine2: Allow setupFilesAfterEnv to export an async function

• jest-circus, jest-test-result: Add startedAt timestamp in TestCaseResultObject within onTestCaseResult

• jest-cli: Export buildArgv

• breaking

  jest-config: Add mts and cts to default moduleFileExtensions config

• breaking

  jest-config: Update testMatch and testRegex default option for supporting mjs, cjs, mts, and cts

• jest-config: Loads config file from provided path in package.json

• jest-config: Allow loading jest.config.cts files

• jest-config: Show rootDir in error message when a preset fails to load

• jest-config: Support loading TS config files using esbuild-register via docblock loader

• jest-config: Allow passing TS config loader options via docblock comment

• jest-config: If Node is running with type stripping enabled, do not require a TS loader

• @jest/core: Group together open handles with the same stack trace (#13417, & #14789)

• @jest/core: Add perfStats to surface test setup overhead

• breaking

  @jest/core: Changed --filter to accept an object with shape { filtered: Array<string> } to match documentation

• @jest/core: Support --outputFile option for --listTests

• @jest/core: Stringify Errors properly with --json flag

• breaking

  @jest/core, @jest/test-sequencer: Exposes globalConfig & contexts to TestSequencer (#14535, & #14543)

• jest-each: Introduce %$ option to add number of the test to its title

• breaking

  @jest/environment: Remove deprecated jest.genMockFromModule()

• breaking

  @jest/environment: Remove unnecessary defensive code

• breaking

  jest-environment-jsdom: Upgrade JSDOM to v22

• @jest/environment-jsdom-abstract: Introduce new package which abstracts over the jsdom environment, allowing usage of custom versions of JSDOM

• jest-environment-node: Update jest environment with dispose symbols Symbol (#14888 & #14909)

• breaking

  expect, @jest/expect: Add type inference for function parameters in CalledWith assertions

• @jest/expect-utils: Properly compare all types of TypedArrays

• breaking

  @jest/fake-timers: Upgrade @sinonjs/fake-timers to v13 (#14544 & #15470)

• @jest/fake-timers: Exposing new modern timers function advanceTimersToFrame() which advances all timers by the needed milliseconds to execute callbacks currently scheduled with requestAnimationFrame

• jest-matcher-utils: Add SERIALIZABLE_PROPERTIES to allow custom serialization of objects

• jest-mock: Add support for the Explicit Resource Management proposal to use the using keyword with jest.spyOn(object, methodName)

• jest-reporters: Add support for DEC mode 2026

• jest-resolver: Support file:// URLs as paths

• [jest-resolve,jest-runtime,jest-resolve-dependencies] Pass the conditions when resolving stub modules

• jest-runtime: Exposing new modern timers function jest.advanceTimersToFrame() from @jest/fake-timers

• jest-runtime: Support import.meta.filename and import.meta.dirname (available from Node 20.11)

• jest-runtime: Support import.meta.resolve

• breaking

  jest-runtime: Make it mandatory to pass globalConfig to the Runtime constructor

• jest-runtime: Add unstable_unmockModule

• jest-runtime: Add onGenerateMock transformer callback for auto generated callbacks (#15433 & #15482)

• breaking

  jest-runtime: Use vm.compileFunction over vm.Script

• @jest/types: test.each(): Accept a readonly (as const) table properly

• @jest/types: Improve argument type inference passed to test and describe callback functions from each tables

• breaking

  jest-snapshot: Add support for Error causes in snapshots

• jest-snapshot: Support Prettier 3

• @jest/util-snapshot: Extract utils used by tooling from jest-snapshot into its own package

• breaking

  pretty-format: Do not render empty string children ('') in React plugin

Fixes

• expect: Show AggregateError to display

• *: Replace exit with exit-x

• babel-plugin-jest-hoist: Use denylist instead of the deprecated blacklist for Babel 8 support

• babel-plugin-jest-hoist: Do not rely on buggy Babel behaviour

• expect: Check error instance type for toThrow/toThrowError

• expect: Improve diff for failing expect.objectContaining

• expect: Use Array.isArray to check if an array is an Array

• expect: Fix Error cause assertion errors

• jest-changed-files: Print underlying errors when VCS commands fail

• jest-changed-files: Abort sl root call if output resembles a steam locomotive

• breaking

  jest-circus: Prevent false test failures caused by promise rejections handled asynchronously

• jest-circus: Replace recursive makeTestResults implementation with iterative one

• jest-circus: Omit expect.hasAssertions() errors if a test already has errors

• jest-circus, jest-expect, jest-snapshot: Pass test.failing tests when containing failing snapshot matchers

• jest-circus: Concurrent tests now emit jest circus events at the correct point and in the expected order.

• breaking

  jest-cli: Validate CLI flags that require arguments receives them

• jest-config: Make sure to respect runInBand option

• jest-config: Support testTimeout in project config

• jest-config: Support coverageReporters in project config

• jest-config: Allow reporters in project config

• jest-config: Allow Node16/NodeNext/Bundler moduleResolution in project's tsconfig

• @jest/create-cache-key-function: Correct the return type of createCacheKey

• jest-each: Allow $keypath templates with null or undefined values

• @jest/expect-utils: Fix comparison of DataView

• breaking

  @jest/expect-utils: Exclude non-enumerable in object matching

• @jest/expect-utils: Fix comparison of URL

• @jest/expect-utils: Check Symbol properties in equality

• @jest/expect-utils: Catch circular references within arrays when matching objects

• @jest/expect-utils: Fix not addressing to Sets and Maps as objects without keys

• jest-haste-map: Fix errors or clobbering with multiple hasteImplModulePaths

• jest-leak-detector: Make leak-detector more aggressive when running GC

• jest-runtime: Properly handle re-exported native modules in ESM via CJS

• jest-runtime: Refactor _importCoreModel so required core module is consistent if modified while loading

• breaking

  jest-schemas, jest-types: Fix type of testFailureExitCode config option

• jest-util: Make sure isInteractive works in a browser

• breaking

  pretty-format: Print ArrayBuffer and DataView correctly

• pretty-format: Fixed a bug where "anonymous custom elements" were not being printed as expected.

• jest-cli: When specifying paths on the command line, only match against the relative paths of the test files

  • [BREAKING] Changes testPathPattern configuration option to testPathPatterns, which now takes a list of patterns instead of the regex.

  • [BREAKING] --testPathPattern is now --testPathPatterns

  • [BREAKING] Specifying testPathPatterns when programmatically calling watch must be specified as new TestPathPatterns(patterns), where TestPathPatterns can be imported from @jest/pattern

• jest-reporters, jest-runner: Unhandled errors without stack get correctly logged to console

• jest-util: Always load mjs files with import

• jest-worker: Properly handle a circular reference error when worker tries to send an assertion fails where either the expected or actual value is circular

• jest-worker: Properly handle a BigInt when worker tries to send an assertion fails where either the expected or actual value is BigInt

• expect: Resolve issue where ObjectContaining matched non-object values. ([#15463])(#15463).

  • Adds a conditional/check to ensure the argument passed to expect is an object.

  • Add unit tests for new ObjectContaining behavior.

  • Remove invalid/wrong test case assertions for ObjectContaining.

• jest-worker: Addresses incorrect state on exit

Performance

• breaking

  *: Bundle all of Jest's modules into index.js (#12348, #14550 & #14661)

• jest-haste-map: Only spawn one process to check for watchman installation

• jest-runner: Better cleanup source-map-support after test to resolve (minor) memory leak

• [jest-circus, jest-environment-node, jest-repl, jest-runner, jest-util] Cleanup global variables on environment teardown to reduce memory leaks (#15215 & #15636 & #15643)

Chore & Maintenance

• security

  [jest-environment-jsdom, jest-environment-jsdom-abstract] Increased version of jsdom to ^26.0.0 (#15325CVE-2024-37890)

• breaking

  *: Drop support for Node.js versions 14, 16, 19, 21 and 23 (#14460, #15118, #15623, #15640)

• breaking

  *: Drop support for typescript@4.3, minimum version is now 5.4 (#14542, #15621)

• breaking

  *: Add ESM wrapper for all of Jest's modules

• breaking

  *: Upgrade to glob@10

• breaking

  babel-jest, babel-preset-jest: Increase peer dependency of @babel/core to ^7.11

• breaking

  expect: Remove .toBeCalled(), .toBeCalledTimes(), .toBeCalledWith(), .lastCalledWith(), .nthCalledWith(), .toReturn(), .toReturnTimes(), .toReturnWith(), .lastReturnedWith(), .nthReturnedWith() and .toThrowError() matcher aliases

• breaking

  jest-cli, jest-config, @jest/types: Remove deprecated --init argument

• breaking

  jest-mock: Remove MockFunctionMetadataType, MockFunctionMetadata and SpyInstance types

Features

• create-jest: Add npm init / yarn create initialiser for Jest projects

• jest-validate: Allow deprecation warnings for unknown options

Fixes

• jest-resolver: Replace unmatched capture groups in moduleNameMapper with empty string instead of undefined

• jest-snapshot: Allow for strings as well as template literals in inline snapshots

• @jest/test-sequencer: Calculate test runtime if perStats.duration is missing

Performance

• @jest/create-cache-key-function: Cache access of NODE_ENV and BABEL_ENV

Fixes

• jest-environment-node: Make sure atob and btoa are writeable in Node 20

• jest-worker: Additional error wrapper for parentPort.postMessage to fix unhandled DataCloneError.

Fixes

• expect, @jest/expect-utils: ObjectContaining support symbol as key

• expect: Remove @types/node from dependencies

• jest-core: Use workers in watch mode by default to avoid crashes (#14059 & #14085).

• jest-reporters: Update istanbul-lib-instrument dependency to v6.

• breaking

  jest-mock: Revert #13692 as it was a breaking change

• breaking

  jest-mock: Revert #13866 as it was a breaking change

• breaking

  jest-mock: Revert #13867 as it was a breaking change

• @jest/reporters: Marks Reporter's hooks as optional

• jest-runtime: Fix dynamic ESM import module bug when loaded module through jest.isolateModulesAsync

Fixes

• jest-circus: Fix snapshot matchers in concurrent tests when nr of tests exceeds maxConcurrency

• @jest/core: When running global setup and teardown, do not try to change the message property of the thrown error object when the message property is unwritable

• jest-snapshot: Move @types/prettier from dependencies to devDependencies

• jest-snapshot: Throw an explicit error if Prettier v3 is used

• jest-reporters: Add "skipped" and "todo" symbols to Github Actions Reporter

Features

• jest-circus, jest-snapshot: Add support for snapshot matchers in concurrent tests

• jest-cli: Include type definitions to generated config files

• jest-snapshot: Support arrays as property matchers

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

Fixes

• jest-circus: Prevent false test failures caused by promise rejections handled asynchronously

• jest-config: Handle frozen config object

• jest-config: Allow coverageDirectory and collectCoverageFrom in project config

• jest-core: Always use workers in watch mode to avoid crashes (#14059).

• jest-environment-jsdom, jest-environment-node: Fix assignment of customExportConditions via testEnvironmentOptions when custom env subclass defines a default value

• jest-matcher-utils: Fix copying value of inherited getters

• jest-mock: Tweak typings to allow jest.replaceProperty() replace methods

• jest-mock: Improve user input validation and error messages of spyOn and replaceProperty methods

• jest-runtime: Bind jest.isolateModulesAsync to this

• jest-runtime: Forward wrapperLength to the Script constructor as columnOffset for accurate debugging

• jest-runtime: Guard _isMockFunction access with in

• jest-snapshot: Fix a potential bug when not using prettier and improve performance

• @jest/transform: Do not instrument .json modules

• jest-worker: Restart a shut down worker before sending it a task

Chore & Maintenance

• security

  *: Update semver dependency to get vulnerability fix

Features

• jest-changed-files: Support Sapling

• jest-circus, @jest/cli, jest-config: Add feature to randomize order of tests via CLI flag or through the config file

• [jest-cli, jest-config, @jest/core, jest-haste-map, @jest/reporters, jest-runner, jest-runtime, @jest/types] Add workerThreads configuration option to allow using worker threads for parallelization

• jest-cli: Export yargsOptions

• jest-config: Add openHandlesTimeout option to configure possible open handles warning.

• @jest/create-cache-key-function: Allow passing length argument to createCacheKey() function and set its default value to 16 on Windows

• jest-message-util: Add support for AggregateError (#13946 & #13947)

• jest-message-util: Add support for Error causes in test and it (#13935 & #13966)

• jest-reporters: Add summaryThreshold option to summary reporter to allow overriding the internal threshold that is used to print the summary of all failed tests when the number of test suites surpasses it

• jest-runtime: Expose @sinonjs/fake-timers async APIs functions advanceTimersByTimeAsync(msToRun) (tickAsync(msToRun)), advanceTimersToNextTimerAsync(steps) (nextAsync), runAllTimersAsync (runAllAsync), and runOnlyPendingTimersAsync (runToLastAsync)

• jest-runtime, @jest/transform: Allow V8 coverage provider to collect coverage from files which were not loaded explicitly

• jest-snapshot: Add support to cts and mts TypeScript files to inline snapshots

• jest-worker: Add start method to worker farms

• jest-worker: Support passing a URL as path to worker

Fixes

• babel-plugin-jest-hoist: Fix unwanted hoisting of nested jest usages

• jest-circus: Send test case results for todo tests

• jest-circus: Update message printed on test timeout

• jest-circus: Avoid creating the word "testfalse" when takesDoneCallback is false in the message printed on test timeout AND updated timeouts test

• jest-environment-jsdom: Stop setting document to null on teardown

• @jest/expect-utils: Update toStrictEqual() to be able to check jest.fn().mock.calls

• @jest/test-result: Allow TestResultsProcessor type to return a Promise

Features

• expect: Update toThrow() to be able to use error causes

• jest-core: Allow to use workerIdleMemoryLimit with only 1 worker or runInBand option

• jest-message-util: Add support for error causes (#13868 & #13912)

• jest-runtime: Revert import assertions for JSON modules as it's been relegated to Stage 2

Fixes

• @jest/expect-utils: subsetEquality should consider also an object's inherited string keys

• jest-mock: Clear mock state when jest.restoreAllMocks() is called

• jest-mock: Prevent mockImplementationOnce and mockReturnValueOnce bleeding into withImplementation

• jest-mock: Do not restore mocks when jest.resetAllMocks() is called

Features

• @jest/core: Instrument significant lifecycle events with performance.mark()

Fixes

• expect, @jest/expect: Provide type of actual as a generic argument to Matchers to allow better-typed extensions

• jest-circus: Added explicit mention of test failing because done() is not being called in error message

• jest-runtime: Handle CJS re-exports of node core modules from ESM

• jest-transform: Downgrade write-file-atomic to v4

• jest-worker: Ignore IPC messages not intended for Jest

Features

• expect, jest-circus, @jest/types: Implement numPassingAsserts of testResults to track the number of passing asserts in a test

• jest-core: Add newlines to JSON output

• @jest/reporters: Automatic log folding in GitHub Actions Reporter

Fixes

• @jest/expect-utils: toMatchObject diffs should include Symbol properties

• jest-runtime: Handle missing replaceProperty

• @jest/types: Add partial support for done callbacks in typings of each

Features

• expect, @jest/expect-utils: Support custom equality testers

• jest-config, jest-worker: Use os.availableParallelism if available to calculate number of workers to spawn

• @jest/globals, jest-mock: Add jest.replaceProperty() that replaces property value

• jest-haste-map: Ignore Sapling vcs directories (.sl/)

• jest-resolve: Support subpath imports (#13705, #13723, #13777)

• jest-runtime: Add jest.isolateModulesAsync for scoped module initialization of asynchronous functions

• jest-runtime: Add jest.isEnvironmentTornDown function

• jest-test-result: Added skipped and focused status to FormattedTestResult

• jest-transform: Support for asynchronous createTransformer

Fixes

• jest-environment-node: Fix non-configurable globals

• @jest/expect-utils: toMatchObject should handle Symbol properties

• jest-mock: Fix mockReset and resetAllMocks undefined return value

• jest-resolve: Add global paths to require.resolve.paths

• jest-resolve: Correct node core module detection when using node: specifiers

• jest-runtime: Support WASM files that import JS resources

• jest-runtime: Use the scriptTransformer cache in jest-runner

• jest-runtime: Enforce import assertions when importing JSON in ESM (#12755 & #13805)

• jest-snapshot: Make sure to import babel outside of the sandbox

• jest-transform: Ensure the correct configuration is passed to preprocessors specified multiple times in the transform option

Features

• jest-runtime: Support WebAssembly (Wasm) imports in ESM modules

Fixes

• jest-config: Add config validation for projects option

• jest-mock: Treat cjs modules as objects so they can be mocked

• jest-worker: Throw an error instead of hanging when jest workers terminate unexpectedly

Fixes

• @jest/test-sequencer: Make sure sharding does not produce empty groups

• jest-circus: Test marked as todo are shown as todo when inside a focussed describe

• jest-mock: Ensure mock resolved and rejected values are promises from correct realm

• jest-snapshot: Don't highlight passing asymmetric property matchers in snapshot diff

Features

• @jest/globals, jest-mock: Add jest.Spied* utility types

Fixes

• jest-environment-node: Make globalThis.performance writable for Node 19 and fake timers

• jest-mock: Revert #13398 to restore mocking of setters

Performance

• *: Use sha1 instead of sha256 for hashing

Features

• @jest/cli, jest-config: A seed for the test run will be randomly generated, or set by a CLI option

• @jest/cli, jest-config: --show-seed will display the seed value in the report, and can be set via a CLI flag or through the config file

• jest-config: Add readInitialConfig utility function

• jest-core: Allow testResultsProcessor to be async

• [@jest/environment, jest-environment-node, jest-environment-jsdom, jest-runtime] Add getSeed() to the jest object

• expect, @jest/expect-utils: Allow isA utility to take a type argument

• expect: Expose AsyncExpectationResult and SyncExpectationResult types

Fixes

• babel-plugin-jest-hoist: Ignore TSTypeQuery when checking for hoisted references

• jest-core: Fix detectOpenHandles false positives for some special objects such as TLSWRAP

• jest-mock: Fix mocking of getters and setters on classes

• jest-reporters: Transform file paths into hyperlinks

• @jest/types: Infer type of each table correctly when the table is a tuple or array

• @jest/types: Rework typings to allow the *ReturnedWith matchers to be called with no argument

Performance

• jest-runner: Do not instrument v8 coverage data if coverage should not be collected

Features

• expect, @jest/expect: Support type inference for function parameters in CalledWith assertions

• expect, @jest/expect: Infer type of *ReturnedWith matchers argument

• @jest/environment, jest-runtime: Allow jest.requireActual and jest.requireMock to take a type argument

• @jest/environment: Allow jest.mock and jest.doMock to take a type argument

• @jest/fake-timers: Add jest.now() to return the current fake clock time (#13244, #13246)

• @jest/mock: Add withImplementation method for temporarily overriding a mock

• expect: Export toThrow* matchers

Fixes

• jest-circus, jest-jasmine2: Fix error messages for Node's assert.throes

• jest-haste-map: Remove __proto__ usage

• jest-mock: Improve spyOn typings to handle optional properties

• jest-mock: Fix mocking of getters and setters on classes

• jest-snapshot: Throw useful error when an array is passed as property matchers

• jest-snapshot: Prioritize parser used in the project

• jest-transform: Attempt to work around issues with atomic writes on Windows

Features

• @jest/environment, jest-runtime: Allow passing a generic type argument to jest.createMockFromModule<T>() method

• expect: Expose ExpectationResult type

• jest-snapshot: Expose Context type

• @jest/globals: Add jest.Mock type helper

Fixes

• jest-core: Capture execError during TestScheduler.scheduleTests and dispatch to reporters

• jest-resolve: Make sure to resolve module paths after looking at exports

• jest-resolve: Improve error on module not found deep in the require stack

• jest-snapshot: Fix typings of snapshot matchers

Features

• jest-transform: Expose TransformFactory type

Fixes

• babel-plugin-jest-hoist: Support imported jest in mock factory

• jest-mock: Align the behavior and return type of generateFromMetadata method

• jest-runtime: Support jest.resetModules() with ESM

Blog post: jestjs.io/blog/2022/08/25/jest-29

Features

• breaking

  expect: Differentiate between MatcherContext MatcherUtils and MatcherState types

• jest-circus: Add support for test.failing.each

• breaking

  jest-config: Make snapshotFormat default to escapeString: false and printBasicPrototype: false

• breaking

  jest-config: Remove undocumented collectCoverageOnlyFrom option

• breaking

  jest-environment-jsdom: Upgrade to jsdom@20 (#13037, #13058)

• @jest/globals: Add jest.Mocked, jest.MockedClass, jest.MockedFunction and jest.MockedObject utility types

• breaking

  jest-mock: Refactor Mocked* utility types. MaybeMockedDeep and MaybeMocked became Mocked and MockedShallow respectively; only deep mocked variants of MockedClass, MockedFunction and MockedObject are exported (#13123, #13124)

• breaking

  jest-mock: Change the default jest.mocked helper’s behavior to deep mocked

• breaking

  jest-snapshot: Let babel find config when updating inline snapshots

• breaking

  @jest/test-result, @jest/types: Replace Bytes and Milliseconds types with number

• jest-worker: Adds workerIdleMemoryLimit option which is used as a check for worker memory leaks >= Node 16.11.0 and recycles child workers as required (#13056, #13105, #13106, #13107)

• breaking

  pretty-format: Remove ConvertAnsi plugin in favour of jest-serializer-ansi-escapes

• pretty-format: Allow to opt out from sorting object keys with compareKeys: null

Fixes

• jest-config: Fix testing multiple projects with TypeScript config files

• @jest/expect-utils: Fix deep equality of ImmutableJS Record

• jest-haste-map: Increase the maximum possible file size that jest-haste-map can handle

• jest-runtime: Properly support CJS re-exports from dual packages

• jest-snapshot: Make prettierPath optional in SnapshotState

• jest-snapshot: Fix parsing error from inline snapshot files with JSX

• jest-worker: When a process runs out of memory worker exits correctly and doesn't spin indefinitely

Chore & Maintenance

• breaking

  *: Drop support for Node v12 and v17

• breaking

  jest-snapshot: Require rootDir as argument to SnapshotState

Features

• jest-leak-detector: Use native FinalizationRegistry when it exists to get rid of external C dependency

Fixes

• jest-changed-files: Fix a lock-up after repeated invocations

• @jest/expect-utils: Fix deep equality of ImmutableJS OrderedSets

• jest-mock: Add index signature support for spyOn types (#13013, #13020)

• jest-snapshot: Fix indentation of awaited inline snapshots

Fixes

• jest-runtime: Avoid star type import from @jest/globals

Features

• jest: Expose Config type

• @jest/reporters: Improve GitHubActionsReporters annotation format

• @jest/types: Infer argument types passed to test and describe callback functions from each tables (#12885, #12905)

Fixes

• @jest/expect-utils: Fix deep equality of ImmutableJS OrderedMaps

• jest-docblock: Handle multiline comments in parseWithComments

• jest-mock: Improve spyOn error messages

• jest-runtime: Correctly report V8 coverage with resetModules: true

• jest-worker: Make JestWorkerFarm helper type to include methods of worker module that take more than one argument

Features

• jest-circus: Add failing test modifier that inverts the behaviour of tests

• jest-environment-node, jest-environment-jsdom: Allow specifying customExportConditions

Fixes

• expect: Adjust typings of lastCalledWith, nthCalledWith, toBeCalledWith matchers to allow a case there a mock was called with no arguments

• @jest/expect-utils: Fix deep equality of ImmutableJS Lists

• jest-core: Do not collect SIGNREQUEST as open handles

Fixes

• jest-config: Normalize reporters option defined in presets

• @jest/reporters: Fix trailing slash in matching coverageThreshold key

• jest-resolve: Fix (experimental) ESM module mocking for re-exports

• @jest/transform: Throw better error if an invalid return value if encountered

Features

• jest-resolve: Expose ResolverOptions type

Fixes

• expect: Add missing dependency jest-util

• jest-circus: Improve test.concurrent

• jest-resolve: Correctly throw an error if jsdom test environment is used, but not installed

Chore & Maintenance

• removed

  jest-serializer: Remove deprecated module from source tree

Blog post: jestjs.io/blog/2022/04/25/jest-28

Features

• babel-jest: Export createTransformer function

• expect: Expose AsymmetricMatchers, MatcherFunction and MatcherFunctionWithState interfaces (#12363, #12376)

• jest-circus: Support error logging before retry

• jest-circus, jest-jasmine2: Allowed classes and functions as describe and it/test names

• breaking

  jest-cli, jest-config: Remove testURL config, use testEnvironmentOptions.url instead

• jest-cli, jest-core: Add --shard parameter for distributed parallel test execution

• breaking

  jest-cli: Remove undocumented --timers option

• breaking

  jest-config: Stop shipping jest-environment-jsdom by default

• breaking

  jest-config: Stop shipping jest-jasmine2 by default

• jest-config, @jest/types: Add ci to GlobalConfig

• breaking

  jest-config: Rename moduleLoader to runtime

• breaking

  jest-config: Rename extraGlobals to sandboxInjectedGlobals

• breaking

  jest-config: Throw an error instead of showing a warning if multiple configs are used

• breaking

  jest-config: Do not normalize long deprecated configuration options preprocessorIgnorePatterns, scriptPreprocessor, setupTestFrameworkScriptFile and testPathDirs

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

• jest-core: Pass project config to globalSetup/globalTeardown function as second argument

• jest-core: Stabilize test runners with event emitters

• breaking

  jest-core, jest-watcher: Move TestWatcher class to jest-watcher package

• jest-core: Allow using Summary Reporter as stand-alone reporter

• breaking

  jest-environment-jsdom: Upgrade jsdom to 19.0.0

• breaking

  jest-environment-jsdom: Add default browser condition to exportConditions for jsdom environment

• breaking

  jest-environment-jsdom: Pass global config to Jest environment constructor for jsdom environment

• breaking

  jest-environment-jsdom: Second argument context to constructor is mandatory

• breaking

  jest-environment-node: Add default node and node-addon conditions to exportConditions for node environment

• breaking

  jest-environment-node: Pass global config to Jest environment constructor for node environment

• breaking

  jest-environment-node: Second argument context to constructor is mandatory

• jest-environment-node: Add all available globals to test globals, not just explicit ones (#12642, #12696)

• @jest/expect: New module which extends expect with jest-snapshot matchers (#12404, #12410, #12418)

• @jest/expect-utils: New module exporting utils for expect

• breaking

  @jest/fake-timers: Rename timers configuration option to fakeTimers

• breaking

  @jest/fake-timers: Allow jest.useFakeTimers() and projectConfig.fakeTimers to take an options bag

• breaking

  jest-haste-map: HasteMap.create now returns a promise

• jest-haste-map: Add support for dependencyExtractor written in ESM

• breaking

  jest-mock: Rename exported utility types ClassLike, FunctionLike, ConstructorLikeKeys, MethodLikeKeys, PropertyLikeKeys; remove exports of utility types ArgumentsOf, ArgsType, ConstructorArgumentsOf - TS builtin utility types ConstructorParameters and Parameters should be used instead (#12435, #12489)

• jest-mock: Improve isMockFunction to infer types of passed function

• breaking

  jest-mock: Improve the usage of jest.fn generic type argument

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

• jest-mock: Add contexts member to mock functions

• @jest/reporters: Add GitHub Actions reporter (#11320, #12658)

• @jest/reporters: Pass reporterContext to custom reporter constructors as third argument

• breaking

  jest-resolve: Add support for package.json exports (#11961, #12373)

• jest-resolve: Support package self-reference

• jest-resolve, jest-runtime: Add support for data: URI import and mock

• jest-resolve, jest-runtime: Add support for async resolver

• breaking

  jest-resolve: Remove browser?: boolean from resolver options, conditions: ['browser'] should be used instead

• jest-resolve: Expose JestResolver, AsyncResolver, SyncResolver, PackageFilter, PathFilter and PackageJSON types (#12707,

• jest-runner: Allow setupFiles module to export an async function

• jest-runner: Allow passing testEnvironmentOptions via docblocks

• jest-runner: Expose CallbackTestRunner, EmittingTestRunner abstract classes and CallbackTestRunnerInterface, EmittingTestRunnerInterface to help typing third party runners (#12646, #12715)

• jest-runner: Lock version of source-map-support to 0.5.13

• breaking

  jest-runtime: Runtime.createHasteMap now returns a promise

• jest-runtime: Calling jest.resetModules function will clear FS and transform cache

• breaking

  jest-runtime: Remove Context type export, it must be imported from @jest/test-result

• jest-runtime: Add import.meta.jest

• @jest/schemas: New module for JSON schemas for Jest's config

• @jest/source-map: Migrate from source-map to @jridgewell/trace-mapping

• breaking

  jest-transform: Make it required for process() and processAsync() methods to always return structured data

• jest-test-result: Add duration property to JSON test output

• breaking

  jest-watcher: Make PatternPrompt class to take entityName as third constructor parameter instead of this._entityName

• breaking

  jest-worker: Allow only absolute workerPath

• breaking

  jest-worker: Default to advanced serialization when using child process workers

• pretty-format: New maxWidth parameter

Fixes

• *: Use sha256 instead of md5 as hashing algortihm for compatibility with FIPS systems

• breaking

  babel-jest: Pass rootDir as root in Babel's options

• expect: Move typings of .not, .rejects and .resolves modifiers outside of Matchers interface

• expect: Throw useful error if expect.extend is called with invalid matchers

• expect: Fix iterableEquality ignores other properties

• expect: Fix print for the closeTo matcher

• jest-changed-files: Improve changedFilesWithAncestor pattern for Mercurial SCM

• jest-circus, @jest/types: Disallow undefined value in TestContext type

• jest-config: Correctly detect CI environment and update snapshots accordingly

• jest-config: Pass moduleTypes to ts-node to enforce CJS when transpiling

• breaking

  jest-config: Add mjs and cjs to default moduleFileExtensions config

• jest-config, jest-haste-map: Allow searching for tests in node_modules by exposing retainAllFiles

• breaking

  jest-core: Exit with status 1 if no tests are found with --findRelatedTests flag

• jest-core: Do not report unref-ed subprocesses as open handles

• jest-each: %# is not replaced with index of the test case

• jest-each: Fixes error message with incorrect count of missing arguments

• jest-environment-jsdom: Make jsdom accessible to extending environments again

• jest-environment-jsdom: Log JSDOM errors more cleanly

• jest-environment-node: Add MessageChannel, MessageEvent to globals

• jest-environment-node: Add structuredClone to globals

• breaking

  @jest/expect-utils: Fix false positives when looking for undefined prop

• jest-haste-map: Don't use partial results if file crawl errors

• jest-haste-map: Make watchman existence check lazy+async

• breaking

  jest-jasmine2, jest-types: Move all jasmine specific types from @jest/types to its own package

• jest-jasmine2: Do not set duration to 0 for skipped tests

• jest-matcher-utils: Pass maxWidth to pretty-format to avoid printing every element in arrays by default

• jest-mock: Fix function overloads for spyOn to allow more correct type inference in complex object

• jest-mock: Handle overridden Function.name property

• @jest/reporters: Notifications generated by the --notify flag are no longer persistent in GNOME Shell.

• @jest/reporters: Move missing icon file which is needed for NotifyReporter class.

• @jest/reporters: Update v8-to-istanbul

• jest-resolver: Call custom resolver with core node.js modules

• jest-runner: Correctly resolve source-map-support

• jest-worker: Fix Farm execution results memory leak

Chore & Maintenance

• breaking

  *: Drop support for Node v10 and v15 and target first LTS 16.13.0

• breaking

  *: Drop support for typescript@3.8, minimum version is now 4.3 (#11142, #12648)

• breaking

  babel-jest: Only export createTransformer

• breaking

  expect: Remove support for importing build/utils

• breaking

  expect: Migrate to ESM

• breaking

  expect: Snapshot matcher types are moved to @jest/expect

• breaking

  jest-config: Remove getTestEnvironment export

• breaking

  jest-config: Rename config option name to id

• breaking

  jest-environment-jsdom: Migrate to ESM

• breaking

  jest-environment-node: Migrate to ESM

• breaking

  jest-jasmine2, jest-runtime: Use Symbol to pass jest.setTimeout value instead of jasmine specific logic

• breaking

  jest-phabricator: Migrate to ESM

• breaking

  jest-resolve: Make requireResolveFunction argument mandatory

• breaking

  jest-runner: Remove some type exports from @jest/test-result

• breaking

  jest-runner: Second argument to constructor (Context) is not optional

• breaking

  jest-serializer: Deprecate package in favour of using v8 APIs directly

• breaking

  jest-snapshot: Migrate to ESM

• breaking

  jest-types: Remove Config.Glob and Config.Path

Performance

• breaking

  jest-haste-map: Default to node crawler over shelling out to find if watchman is not enabled