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. (#15567)
• [babel-jest] Add option excludeJestPreset to allow opting out of babel-preset-jest (#15164)
• [expect] Revert #15038 to fix expect(fn).toHaveBeenCalledWith(expect.objectContaining(...)) when there are multiple calls (#15508)
• [jest-circus, jest-cli, jest-config] Add waitNextEventLoopTurnForUnhandledRejectionEvents flag to minimise performance impact of correct detection of unhandled promise rejections introduced in #14315 (#14681)
• [jest-circus] Add a waitBeforeRetry option to jest.retryTimes (#14738)
• [jest-circus] Add a retryImmediately option to jest.retryTimes (#14696)
• [jest-circus, jest-jasmine2] Allow setupFilesAfterEnv to export an async function (#10962)
• [jest-circus, jest-test-result] Add startedAt timestamp in TestCaseResultObject within onTestCaseResult (#15145)
• [jest-cli] Export buildArgv (#15310)
• [jest-config] [BREAKING] Add mts and cts to default moduleFileExtensions config (#14369)
• [jest-config] [BREAKING] Update testMatch and testRegex default option for supporting mjs, cjs, mts, and cts (#14584)
• [jest-config] Loads config file from provided path in package.json (#14044)
• [jest-config] Allow loading jest.config.cts files (#14070)
• [jest-config] Show rootDir in error message when a preset fails to load (#15194)
• [jest-config] Support loading TS config files using esbuild-register via docblock loader (#15190)
• [jest-config] Allow passing TS config loader options via docblock comment (#15234)
• [jest-config] If Node is running with type stripping enabled, do not require a TS loader (#15480)
• [@jest/core] Group together open handles with the same stack trace (#13417, & #14789)
• [@jest/core] Add perfStats to surface test setup overhead (#14622)
• [@jest/core] [BREAKING] Changed --filter to accept an object with shape { filtered: Array<string> } to match documentation (#13319)
• [@jest/core] Support --outputFile option for --listTests (#14980)
• [@jest/core] Stringify Errors properly with --json flag (#15329)
• [@jest/core, @jest/test-sequencer] [BREAKING] Exposes globalConfig & contexts to TestSequencer (#14535, & #14543)
• [jest-each] Introduce %$ option to add number of the test to its title (#14710)
• [@jest/environment] [BREAKING] Remove deprecated jest.genMockFromModule() (#15042)
• [@jest/environment] [BREAKING] Remove unnecessary defensive code (#15045)
• [jest-environment-jsdom] [BREAKING] Upgrade JSDOM to v22 (#13825)
• [@jest/environment-jsdom-abstract] Introduce new package which abstracts over the jsdom environment, allowing usage of custom versions of JSDOM (#14717)
• [jest-environment-node] Update jest environment with dispose symbols Symbol (#14888 & #14909)
• [expect, @jest/expect] [BREAKING] Add type inference for function parameters in CalledWith assertions (#15129)
• [@jest/expect-utils] Properly compare all types of TypedArrays (#15178)
• [@jest/fake-timers] [BREAKING] 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 (#14598)
• [jest-matcher-utils] Add SERIALIZABLE_PROPERTIES to allow custom serialization of objects (#14893)
• [jest-mock] Add support for the Explicit Resource Management proposal to use the using keyword with jest.spyOn(object, methodName) (#14895)
• [jest-reporters] Add support for DEC mode 2026 (#15008)
• [jest-resolver] Support file:// URLs as paths (#15154)
• [jest-resolve,jest-runtime,jest-resolve-dependencies] Pass the conditions when resolving stub modules (#15489)
• [jest-runtime] Exposing new modern timers function jest.advanceTimersToFrame() from @jest/fake-timers (#14598)
• [jest-runtime] Support import.meta.filename and import.meta.dirname (available from Node 20.11) (#14854)
• [jest-runtime] Support import.meta.resolve (#14930)
• [jest-runtime] [BREAKING] Make it mandatory to pass globalConfig to the Runtime constructor (#15044)
• [jest-runtime] Add unstable_unmockModule (#15080)
• [jest-runtime] Add onGenerateMock transformer callback for auto generated callbacks (#15433 & #15482)
• [jest-runtime] [BREAKING] Use vm.compileFunction over vm.Script (#15461)
• [@jest/schemas] Upgrade @sinclair/typebox to v0.34 (#15450)
• [@jest/types] test.each(): Accept a readonly (as const) table properly (#14565)
• [@jest/types] Improve argument type inference passed to test and describe callback functions from each tables (#14920)
• [jest-snapshot] [BREAKING] Add support for Error causes in snapshots (#13965)
• [jest-snapshot] Support Prettier 3 (#14566)
• [@jest/util-snapshot] Extract utils used by tooling from jest-snapshot into its own package (#15095)
• [pretty-format] [BREAKING] Do not render empty string children ('') in React plugin (#14470)

Fixes

• [expect] Show AggregateError to display (#15346)
• [*] Replace exit with exit-x (#15399)
• [babel-plugin-jest-hoist] Use denylist instead of the deprecated blacklist for Babel 8 support (#14109)
• [babel-plugin-jest-hoist] Do not rely on buggy Babel behaviour (#15415)
• [expect] Check error instance type for toThrow/toThrowError (#14576)
• [expect] Improve diff for failing expect.objectContaining (#15038)
• [expect] Use Array.isArray to check if an array is an Array (#15101)
• [expect] Fix Error cause assertion errors (#15339)
• [jest-changed-files] Print underlying errors when VCS commands fail (#15052)
• [jest-changed-files] Abort sl root call if output resembles a steam locomotive (#15053)
• [jest-circus] [BREAKING] Prevent false test failures caused by promise rejections handled asynchronously (#14315)
• [jest-circus] Replace recursive makeTestResults implementation with iterative one (#14760)
• [jest-circus] Omit expect.hasAssertions() errors if a test already has errors (#14866)
• [jest-circus, jest-expect, jest-snapshot] Pass test.failing tests when containing failing snapshot matchers (#14313)
• [jest-circus] Concurrent tests now emit jest circus events at the correct point and in the expected order. (#15381)
• [jest-cli] [BREAKING] Validate CLI flags that require arguments receives them (#14783)
• [jest-config] Make sure to respect runInBand option (#14578)
• [jest-config] Support testTimeout in project config (#14697)
• [jest-config] Support coverageReporters in project config (#14697)
• [jest-config] Allow reporters in project config (#14768)
• [jest-config] Allow Node16/NodeNext/Bundler moduleResolution in project's tsconfig (#14739)
• [@jest/create-cache-key-function] Correct the return type of createCacheKey (#15159)
• [jest-each] Allow $keypath templates with null or undefined values (#14831)
• [@jest/expect-utils] Fix comparison of DataView (#14408)
• [@jest/expect-utils] [BREAKING] exclude non-enumerable in object matching (#14670)
• [@jest/expect-utils] Fix comparison of URL (#14672)
• [@jest/expect-utils] Check Symbol properties in equality (#14688)
• [@jest/expect-utils] Catch circular references within arrays when matching objects (#14894)
• [@jest/expect-utils] Fix not addressing to Sets and Maps as objects without keys (#14873)
• [jest-haste-map] Fix errors or clobbering with multiple hasteImplModulePaths (#15522)
• [jest-leak-detector] Make leak-detector more aggressive when running GC (#14526)
• [jest-runtime] Properly handle re-exported native modules in ESM via CJS (#14589)
• [jest-runtime] Refactor _importCoreModel so required core module is consistent if modified while loading (#15077)
• [jest-schemas, jest-types] [BREAKING] Fix type of testFailureExitCode config option(#15232)
• [jest-util] Make sure isInteractive works in a browser (#14552)
• [pretty-format] [BREAKING] Print ArrayBuffer and DataView correctly (#14290)
• [pretty-format] Fixed a bug where "anonymous custom elements" were not being printed as expected. (#15138)
• [jest-cli] When specifying paths on the command line, only match against the relative paths of the test files (#12519)
  • [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 (#14619)
• [jest-util] Always load mjs files with import (#15447)
• [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 (#15191)
• [jest-worker] Properly handle a BigInt when worker tries to send an assertion fails where either the expected or actual value is BigInt (#15191)
• [expect] Resolve issue where ObjectContaining matched non-object values. ([#15463])(https://github.com/jestjs/jest/pull/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 (#15610)

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 (#14826)
• [jest-runner] Better cleanup source-map-support after test to resolve (minor) memory leak (#15233)
• [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

• [jest-environment-jsdom, jest-environment-jsdom-abstract] Increased version of jsdom to ^26.0.0 (#15325CVE-2024-37890)
• [*] Increase version of micromatch to ^4.0.7 (#15082)
• [*] [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)
• [*] Depend on exact versions of monorepo dependencies instead of ^ range (#14553)
• [*] [BREAKING] Add ESM wrapper for all of Jest's modules (#14661)
• [*] [BREAKING] Upgrade to glob@10 (#14509)
• [*] Use TypeError over Error where appropriate (#14799)
• [docs] Fix typos in CHANGELOG.md and packages/jest-validate/README.md (#14640)
• [docs] Don't use alias matchers in docs (#14631)
• [babel-jest, babel-preset-jest] [BREAKING] Increase peer dependency of @babel/core to ^7.11 (#14109)
• [babel-jest, @jest/transform] Update babel-plugin-istanbul to v6 (#15156)
• [babel-plugin-jest-hoist] Move unnecessary dependencies to devDependencies (#15010)
• [expect] [BREAKING] Remove .toBeCalled(), .toBeCalledTimes(), .toBeCalledWith(), .lastCalledWith(), .nthCalledWith(), .toReturn(), .toReturnTimes(), .toReturnWith(), .lastReturnedWith(), .nthReturnedWith() and .toThrowError() matcher aliases (#14632)
• [jest-cli, jest-config, @jest/types] [BREAKING] Remove deprecated --init argument (#14490)
• [jest-config, @jest/core, jest-util] Upgrade ci-info (#14655)
• [jest-mock] [BREAKING] Remove MockFunctionMetadataType, MockFunctionMetadata and SpyInstance types (#14621)
• [@jest/reporters] Upgrade istanbul-lib-source-maps (#14924)
• [jest-schemas] Upgrade @sinclair/typebox (#14775)
• [jest-transform] Upgrade write-file-atomic (#14274)
• [jest-util] Upgrade picomatch to v4 (#14653 & #14885)
• [docs] Append to NODE_OPTIONS, not overwrite ([#14730](https://github.com/jestjs/jest/pull/14730))
• [docs] Updated .toHaveBeenCalled() documentation to correctly reflect its functionality (#14842)
• [docs] Link NestJS documentation on testing with Jest (#14940)
• [docs] Revised documentation for .toHaveBeenCalled() to accurately depict its functionality. (#14853)
• [docs] Removed ExpressJS reference link from documentation due to dead link (#15270)
• [docs] Correct broken links in docs (#15359)

New Contributors

• @Eric-Tyrrell22 made their first contribution in https://github.com/jestjs/jest/pull/14535
• @Dunqing made their first contribution in https://github.com/jestjs/jest/pull/14290
• @maro1993 made their first contribution in https://github.com/jestjs/jest/pull/14175
• @mknight-atl made their first contribution in https://github.com/jestjs/jest/pull/14560
• @verycosy made their first contribution in https://github.com/jestjs/jest/pull/14576
• @Peeja made their first contribution in https://github.com/jestjs/jest/pull/14565
• @KhaledElmorsy made their first contribution in https://github.com/jestjs/jest/pull/14313
• @alexreardon made their first contribution in https://github.com/jestjs/jest/pull/14598
• @nolddor made their first contribution in https://github.com/jestjs/jest/pull/14611
• @Mutesa-Cedric made their first contribution in https://github.com/jestjs/jest/pull/14613
• @the-ress made their first contribution in https://github.com/jestjs/jest/pull/14619
• @shresthasurav made their first contribution in https://github.com/jestjs/jest/pull/14640
• @fa93hws made their first contribution in https://github.com/jestjs/jest/pull/14670
• @tr1ckydev made their first contribution in https://github.com/jestjs/jest/pull/14672
• @mattkubej made their first contribution in https://github.com/jestjs/jest/pull/14622
• @DaniAcu made their first contribution in https://github.com/jestjs/jest/pull/14688
• @RayBrokeSomething made their first contribution in https://github.com/jestjs/jest/pull/14697
• @rafaelrabelos made their first contribution in https://github.com/jestjs/jest/pull/14044
• @someone635 made their first contribution in https://github.com/jestjs/jest/pull/14730
• @faizanu94 made their first contribution in https://github.com/jestjs/jest/pull/14625
• @casey-lentz made their first contribution in https://github.com/jestjs/jest/pull/14763
• @WillianAgostini made their first contribution in https://github.com/jestjs/jest/pull/14738
• @jeremiah-snee-openx made their first contribution in https://github.com/jestjs/jest/pull/14768
• @ginabethrussell made their first contribution in https://github.com/jestjs/jest/pull/14747
• @vkml made their first contribution in https://github.com/jestjs/jest/pull/14749
• @DerTimonius made their first contribution in https://github.com/jestjs/jest/pull/14070
• @JimminiKin made their first contribution in https://github.com/jestjs/jest/pull/14830
• @arescrimson made their first contribution in https://github.com/jestjs/jest/pull/14847
• @notaphplover made their first contribution in https://github.com/jestjs/jest/pull/14888
• @bensternthal made their first contribution in https://github.com/jestjs/jest/pull/14904
• @phryneas made their first contribution in https://github.com/jestjs/jest/pull/14895
• @CheadleCheadle made their first contribution in https://github.com/jestjs/jest/pull/14930
• @Germandrummer92 made their first contribution in https://github.com/jestjs/jest/pull/14831
• @hkdobrev made their first contribution in https://github.com/jestjs/jest/pull/14940
• @MathieuFedrigo made their first contribution in https://github.com/jestjs/jest/pull/14920
• @georgekaran made their first contribution in https://github.com/jestjs/jest/pull/14893
• @manoraj made their first contribution in https://github.com/jestjs/jest/pull/14980
• @ShuZhong made their first contribution in https://github.com/jestjs/jest/pull/14957
• @peterdenham made their first contribution in https://github.com/jestjs/jest/pull/14988
• @Vadimchesh made their first contribution in https://github.com/jestjs/jest/pull/14977
• @haze made their first contribution in https://github.com/jestjs/jest/pull/15008
• @ofekm97 made their first contribution in https://github.com/jestjs/jest/pull/14873
• @rmartine-ias made their first contribution in https://github.com/jestjs/jest/pull/15052
• @colinacassidy made their first contribution in https://github.com/jestjs/jest/pull/15038
• @dnicolson made their first contribution in https://github.com/jestjs/jest/pull/15056
• @mukul-turing made their first contribution in https://github.com/jestjs/jest/pull/14853
• @akwodkiewicz made their first contribution in https://github.com/jestjs/jest/pull/14739
• @brandonchinn178 made their first contribution in https://github.com/jestjs/jest/pull/14934
• @davidroeca made their first contribution in https://github.com/jestjs/jest/pull/14913
• @Avi-E-Koenig made their first contribution in https://github.com/jestjs/jest/pull/15096
• @kemuridama made their first contribution in https://github.com/jestjs/jest/pull/14710
• @mouadhbb made their first contribution in https://github.com/jestjs/jest/pull/15082
• @eyalroth made their first contribution in https://github.com/jestjs/jest/pull/15129
• @BondarenkoAlex made their first contribution in https://github.com/jestjs/jest/pull/15080
• @KonnorRogers made their first contribution in https://github.com/jestjs/jest/pull/15138
• @fynsta made their first contribution in https://github.com/jestjs/jest/pull/15149
• @latin-1 made their first contribution in https://github.com/jestjs/jest/pull/15164
• @Jon-Biz made their first contribution in https://github.com/jestjs/jest/pull/15122
• @RahulARanger made their first contribution in https://github.com/jestjs/jest/pull/15145
• @askoufis made their first contribution in https://github.com/jestjs/jest/pull/15194
• @henny1105 made their first contribution in https://github.com/jestjs/jest/pull/15246
• @brandonnorsworthy made their first contribution in https://github.com/jestjs/jest/pull/15270
• @jzaefferer made their first contribution in https://github.com/jestjs/jest/pull/15266
• @ZuBB made their first contribution in https://github.com/jestjs/jest/pull/15328
• @ikonst made their first contribution in https://github.com/jestjs/jest/pull/15315
• @gagan-bhullar-tech made their first contribution in https://github.com/jestjs/jest/pull/15311
• @jayvdb made their first contribution in https://github.com/jestjs/jest/pull/15422
• @dongwa made their first contribution in https://github.com/jestjs/jest/pull/15310
• @mohammednumaan made their first contribution in https://github.com/jestjs/jest/pull/15437
• @madcapnmckay made their first contribution in https://github.com/jestjs/jest/pull/15381
• @tonyd33 made their first contribution in https://github.com/jestjs/jest/pull/15329
• @hyperupcall made their first contribution in https://github.com/jestjs/jest/pull/15426
• @andrew-the-drawer made their first contribution in https://github.com/jestjs/jest/pull/15489
• @jonasongg made their first contribution in https://github.com/jestjs/jest/pull/15517
• @danielrentz made their first contribution in https://github.com/jestjs/jest/pull/15514
• @co63oc made their first contribution in https://github.com/jestjs/jest/pull/15527
• @thypon made their first contribution in https://github.com/jestjs/jest/pull/15559
• @pengqiseven made their first contribution in https://github.com/jestjs/jest/pull/15602
• @anbnyc made their first contribution in https://github.com/jestjs/jest/pull/15521
• @tez3998 made their first contribution in https://github.com/jestjs/jest/pull/15359
• @dev-intj made their first contribution in https://github.com/jestjs/jest/pull/15605
• @zakingslayerv22 made their first contribution in https://github.com/jestjs/jest/pull/15583
• @loganrosen made their first contribution in https://github.com/jestjs/jest/pull/15498
• @dancer1325 made their first contribution in https://github.com/jestjs/jest/pull/15486
• @sebastiancarlos made their first contribution in https://github.com/jestjs/jest/pull/15372
• @cgm-16 made their first contribution in https://github.com/jestjs/jest/pull/15551
• @ecraig12345 made their first contribution in https://github.com/jestjs/jest/pull/15508
• @icholy made their first contribution in https://github.com/jestjs/jest/pull/15567
• @satanTime made their first contribution in https://github.com/jestjs/jest/pull/11529
• @JounQin made their first contribution in https://github.com/jestjs/jest/pull/15617
• @Dreamsorcerer made their first contribution in https://github.com/jestjs/jest/pull/15622
• @andreibereczki made their first contribution in https://github.com/jestjs/jest/pull/15473
• @noritaka1166 made their first contribution in https://github.com/jestjs/jest/pull/15629
• @gustav0d made their first contribution in https://github.com/jestjs/jest/pull/15648

See the CHANGELOG.