Zum Inhalt springen
verdict:

Jest 30.5.0

notable

Release Notes

note: die Zusammenfassung und die Release Notes sind auf Englisch

ok: Upgrade unbedenklich

0 Breaking Changes5 Kernpunkte

Adds whenCalledWith mocks, describe-level retries and a new watcher, with many ESM and resolver fixes.

Zusammenfassung · nur aus den Release Notes · claude-haiku-5-5 · prompt v7

Kernpunkte

release-notesgithub.com/jestjs/jest · 240 Zeilen
  1. 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 🇳🇴
  3. ---
  5. 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](https://github.com/jestjs/jest/issues).
  7. # Highlights
  9. ## `whenCalledWith`
  11. Mock functions can now configure return values per argument list, contributed by [@timkindberg](https://github.com/timkindberg) ([#16053](https://github.com/jestjs/jest/pull/16053)):
  13. ```js
  14. const fn = jest.fn();
  15. fn.whenCalledWith('apple').mockReturnValue('red');
  16. fn.whenCalledWith('banana').mockReturnValue('yellow');
  17. fn.whenCalledWith(expect.any(Number)).mockReturnValue('numeric');
  19. fn('apple'); // 'red'
  20. fn('banana'); // 'yellow'
  21. fn(42); // 'numeric'
  22. fn('grape'); // undefined
  23. ```
  25. 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](https://jestjs.io/docs/mock-function-api#mockfnwhencalledwithargs) for matching and precedence details.
  27. ## Describe-level retries
  29. `jest.retryTimes()` can now retry a whole `describe` block instead of a single test, contributed by [@soltonigiri](https://github.com/soltonigiri) ([#16322](https://github.com/jestjs/jest/pull/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:
  31. ```js
  32. describe('workflow', () => {
  33. jest.retryTimes(3, {entireDescribe: true});
  35. test('first step', () => {});
  36. test('second step', () => {}); // a failure retries the entire block
  37. });
  38. ```
  40. ## New file watcher
  42. The non-watchman path of `jest-haste-map` is rewritten. `@parcel/watcher` replaces the homegrown `NodeWatcher` and `FSEventsWatcher` ([#16188](https://github.com/jestjs/jest/pull/16188)), and `fdir` replaces the hand-rolled directory recursion in the crawler ([#16187](https://github.com/jestjs/jest/pull/16187)). A batch of fixes also makes watching and indexing survive locked files on Windows, watchman failures, and duplicate manual mocks ([#16295](https://github.com/jestjs/jest/pull/16295), [#16358](https://github.com/jestjs/jest/pull/16358), [#16355](https://github.com/jestjs/jest/pull/16355), [#16360](https://github.com/jestjs/jest/pull/16360)).
  44. 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 👍
  46. ## Long-requested dependency updates
  48. - `babel-plugin-istanbul` is updated to v8 ([#16049](https://github.com/jestjs/jest/pull/16049))
  49. - `glob` is updated to v13 ([#16397](https://github.com/jestjs/jest/pull/16397))
  50. - `source-map-support` is replaced with an implementation in `@jest/source-map` ([#16327](https://github.com/jestjs/jest/pull/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.
  52. ## Performance
  54. - Warm module resolution costs about a third of what it did, and repeated work is gone from the resolution hot path ([#16373](https://github.com/jestjs/jest/pull/16373), [#16371](https://github.com/jestjs/jest/pull/16371)).
  55. - 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](https://github.com/jestjs/jest/pull/16376)).
  56. - `jest-snapshot` loads babel, semver and synckit lazily, so every test process loads ~200 fewer modules ([#16387](https://github.com/jestjs/jest/pull/16387)).
  57. - `jest-haste-map` caches the watchman socket path, so warm runs spawn no watchman processes ([#16386](https://github.com/jestjs/jest/pull/16386)), and reuses cached metadata for duplicated haste names instead of re-parsing them on every startup ([#16351](https://github.com/jestjs/jest/pull/16351)).
  59. ## More new APIs
  61. - Snapshot failures expose the `.snap` file path as `matcherResult.snapshotPath` in `failureDetails` ([#16374](https://github.com/jestjs/jest/pull/16374)).
  62. - `--collectTests` expands `test.each`/`describe.each` cases and reports per-status counts plus a summary line that matches a real run ([#16259](https://github.com/jestjs/jest/pull/16259)).
  63. - `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](https://github.com/jestjs/jest/pull/16316)).
  65. ## ESM
  67. A long list of fixes brings `jest-runtime`'s module system closer to Node's:
  69. - 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](https://github.com/jestjs/jest/pull/16391)).
  70. - 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](https://github.com/jestjs/jest/pull/16389), [#16365](https://github.com/jestjs/jest/pull/16365)).
  71. - `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](https://github.com/jestjs/jest/pull/16364) through [#16391](https://github.com/jestjs/jest/pull/16391)).
  72. - The `module-sync` export condition resolves, so packages that expose their ESM entry point for `require()` load the same file Node picks ([#16336](https://github.com/jestjs/jest/pull/16336)).
  74. The intentional divergences from Node's module system are now documented on the [ECMAScript Modules page](https://jestjs.io/docs/ecmascript-modules) ([#16368](https://github.com/jestjs/jest/pull/16368)).
  76. ## Resolver
  78. - The default resolver honors Node's `--preserve-symlinks` / `NODE_PRESERVE_SYMLINKS` ([#16260](https://github.com/jestjs/jest/pull/16260)).
  79. - `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](https://github.com/jestjs/jest/pull/16390), [#16388](https://github.com/jestjs/jest/pull/16388)).
  80. - A user resolver can be written as an ES module ([#16332](https://github.com/jestjs/jest/pull/16332)).
  82. 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 😀
  84. ---
  86. ## Features
  88. - `[@jest/expect-utils, jest-mock]` Add `mockFn.whenCalledWith(...args)` for configuring return values per argument list, with first-class asymmetric-matcher support ([#16053](https://github.com/jestjs/jest/pull/16053))
  89. - `[@jest/expect-utils]` Export `AsymmetricMatcher` and `FunctionParameters` types (previously private to `expect`) ([#16053](https://github.com/jestjs/jest/pull/16053))
  90. - `[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 ([#16259](https://github.com/jestjs/jest/pull/16259))
  91. - `[jest-circus, jest-environment, jest-runtime, jest-types]` Add describe-level retries via `jest.retryTimes(..., {entireDescribe: true})` ([#16322](https://github.com/jestjs/jest/pull/16322))
  92. - `[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 ([#16316](https://github.com/jestjs/jest/pull/16316))
  93. - `[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 ([#16316](https://github.com/jestjs/jest/pull/16316))
  94. - `[jest-haste-map]` Replace `NodeWatcher` and `FSEventsWatcher` with `@parcel/watcher` for the non-watchman watch path ([#16188](https://github.com/jestjs/jest/pull/16188))
  95. - `[jest-resolve]` Bump `unrs-resolver` to 1.12.1, remove `jest-pnp-resolver` and unnecessary checks ([#15721](https://github.com/jestjs/jest/pull/15721))
  96. - `[jest-resolve]` Honor Node's `--preserve-symlinks` / `NODE_PRESERVE_SYMLINKS` in the default resolver by passing `symlinks: false` to `unrs-resolver` ([#16260](https://github.com/jestjs/jest/pull/16260))
  97. - `[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 ([#16391](https://github.com/jestjs/jest/pull/16391))
  98. - `[jest-runtime]` Route `process.getBuiltinModule` through the sandbox, so it returns the sandbox `process` and the hooked `node:module` instead of the host's ([#16391](https://github.com/jestjs/jest/pull/16391))
  99. - `[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 ([#16391](https://github.com/jestjs/jest/pull/16391))
  100. - `[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 ([#16391](https://github.com/jestjs/jest/pull/16391))
  101. - `[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" ([#16391](https://github.com/jestjs/jest/pull/16391))
  102. - `[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 ([#16391](https://github.com/jestjs/jest/pull/16391))
  103. - `[jest-runtime]` Set `import.meta.main` to `true` in the test file and `false` in every module it loads, matching Node 24+ ([#16367](https://github.com/jestjs/jest/pull/16367))
  104. - `[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 ([#16336](https://github.com/jestjs/jest/pull/16336))
  105. - `[jest-snapshot]` Add external snapshot paths to custom reporter failure details ([#16374](https://github.com/jestjs/jest/pull/16374))
  107. ## Fixes
  109. - `[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 ([#16155](https://github.com/jestjs/jest/pull/16155))
  110. - `[expect, jest-message-util, jest-pattern, jest-regex-util, jest-util]` Revert `node:` protocol imports to restore webpack/browser-bundle compatibility ([#16167](https://github.com/jestjs/jest/pull/16167))
  111. - `[expect]` Widen `toMatchObject` and `objectContaining` parameter type from `Record<string, unknown>` to `object` so class instances are accepted ([#16196](https://github.com/jestjs/jest/pull/16196))
  112. - `[jest-circus]` Call a generator test body with the shared test context, so `this` matches what a regular test function receives ([#16347](https://github.com/jestjs/jest/pull/16347))
  113. - `[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 ([#16347](https://github.com/jestjs/jest/pull/16347))
  114. - `[jest-circus]` Clear `currentlyRunningTest` after skipped and todo tests ([#16342](https://github.com/jestjs/jest/pull/16342))
  115. - `[jest-circus]` Prevent late `done()` callbacks from affecting later test or hook invocations ([#16343](https://github.com/jestjs/jest/pull/16343))
  116. - `[jest-circus, jest-jasmine2]` Honor `--expand` when formatting `node:assert` failures, instead of always collapsing the diff ([#16347](https://github.com/jestjs/jest/pull/16347))
  117. - `[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 ([#16316](https://github.com/jestjs/jest/pull/16316))
  118. - `[jest-circus, jest-snapshot]` Keep snapshot state and counts correct when a test retries ([#16344](https://github.com/jestjs/jest/pull/16344))
  119. - `[@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 ([#16331](https://github.com/jestjs/jest/pull/16331))
  120. - `[@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 ([#16331](https://github.com/jestjs/jest/pull/16331))
  121. - `[@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 ([#16331](https://github.com/jestjs/jest/pull/16331))
  122. - `[jest-config]` Add missing `findRelatedTests`, `outputFile`, and `replname` entries to `ValidConfig` so they no longer trigger spurious "Unknown option" warnings ([#16224](https://github.com/jestjs/jest/pull/16224))
  123. - `[jest-config]` Use `--config` for the global config when multiple `--projects` are specified ([#16273](https://github.com/jestjs/jest/pull/16273))
  124. - `[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` ([#16338](https://github.com/jestjs/jest/pull/16338))
  125. - `[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 ([#16379](https://github.com/jestjs/jest/pull/16379))
  126. - `[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 ([#16338](https://github.com/jestjs/jest/pull/16338))
  127. - `[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 ([#16338](https://github.com/jestjs/jest/pull/16338))
  128. - `[jest-environment, jest-runtime]` Bind `sandboxInjectedGlobals` to the right values when `injectGlobals` is `false`, instead of shifting every one of them by a position ([#16377](https://github.com/jestjs/jest/pull/16377))
  129. - `[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 ([#16323](https://github.com/jestjs/jest/pull/16323))
  130. - `[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 ([#16324](https://github.com/jestjs/jest/pull/16324))
  131. - `[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` ([#16295](https://github.com/jestjs/jest/pull/16295))
  132. - `[jest-haste-map]` Keep indexing when an outside process holds a file open on Windows, instead of failing the whole crawl on `EPERM` ([#16358](https://github.com/jestjs/jest/pull/16358))
  133. - `[jest-haste-map]` Keep a duplicated manual mock resolving when the file it pointed at is deleted in watch mode ([#16360](https://github.com/jestjs/jest/pull/16360))
  134. - `[jest-haste-map]` Shut the worker farm down when a duplicate manual mock aborts the build under `throwOnModuleCollision` ([#16354](https://github.com/jestjs/jest/pull/16354))
  135. - `[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 ([#16355](https://github.com/jestjs/jest/pull/16355))
  136. - `[jest-haste-map]` Stop delivering watch events after `WatchmanWatcher` is closed, and route its warnings through the configured console ([#16355](https://github.com/jestjs/jest/pull/16355))
  137. - `[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` ([#16353](https://github.com/jestjs/jest/pull/16353))
  138. - `[jest-haste-map]` Match watched files on a full extension, so `moduleFileExtensions: ['js']` no longer accepts `foo.mjs` ([#16352](https://github.com/jestjs/jest/pull/16352))
  139. - `[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 ([#16352](https://github.com/jestjs/jest/pull/16352))
  140. - `[jest-message-util]` Print the inner errors of an `AggregateError` thrown inside a test ([#16316](https://github.com/jestjs/jest/pull/16316))
  141. - `[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 ([#16316](https://github.com/jestjs/jest/pull/16316))
  142. - `[jest-message-util]` Color stack traces line by line so blank lines stay blank ([#16316](https://github.com/jestjs/jest/pull/16316))
  143. - `[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 ([#16326](https://github.com/jestjs/jest/pull/16326))
  144. - `[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']`) ([#16237](https://github.com/jestjs/jest/pull/16237))
  145. - `[@jest-environment/jsdom-abstract]` Make `@types/jsdom` a peer dependency ([#16166](https://github.com/jestjs/jest/pull/16166))
  146. - `[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 ([#16226](https://github.com/jestjs/jest/pull/16226))
  147. - `[jest-resolve]` Include `extensionsToTreatAsEsm` in the `shouldLoadAsEsm` cache key, so projects with different extension lists don't read each other's answers ([#16369](https://github.com/jestjs/jest/pull/16369))
  148. - `[jest-resolve]` Make `getModuleIDAsync` build and cache `data:` URI module IDs the same way as `getModuleID` ([#16370](https://github.com/jestjs/jest/pull/16370))
  149. - `[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 ([#16388](https://github.com/jestjs/jest/pull/16388))
  150. - `[jest-resolve]` Look up manual mocks for `node:` protocol specifiers under the unprefixed name they are stored as ([#16388](https://github.com/jestjs/jest/pull/16388))
  151. - `[jest-resolve]` Apply `moduleNameMapper` consistently to both spellings of core module specifiers (`fs` vs `node:fs`) ([#16390](https://github.com/jestjs/jest/pull/16390))
  152. - `[jest-resolve]` Keep virtual and ordinary mock module IDs isolated across test files ([#16296](https://github.com/jestjs/jest/pull/16296))
  153. - `[jest-resolve]` Guard missing `require.resolve.paths` ([#16052](https://github.com/jestjs/jest/pull/16052))
  154. - `[jest-resolve, jest-config, jest-runner]` Support a user resolver written as an ES module ([#16332](https://github.com/jestjs/jest/pull/16332))
  155. - `[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 ([#16368](https://github.com/jestjs/jest/pull/16368))
  156. - `[@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 ([#16327](https://github.com/jestjs/jest/pull/16327))
  157. - `[@jest/source-map]` Look up `--testLocationInResults` positions at the right column, and keep a mapping to the first column instead of discarding it ([#16327](https://github.com/jestjs/jest/pull/16327))
  158. - `[@jest/source-map]` Warn when a source map cannot be parsed, instead of silently leaving its frames untranslated ([#16327](https://github.com/jestjs/jest/pull/16327))
  159. - `[jest-runner, @jest/source-map]` Keep a source-mapped stack for an error thrown after the test environment was torn down ([#16327](https://github.com/jestjs/jest/pull/16327))
  160. - `[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 ([#16330](https://github.com/jestjs/jest/pull/16330))
  161. - `[jest-runtime]` Report that no coverage was collected when `getAllV8CoverageInfoCopy` is called after `teardown`, instead of returning an empty result ([#16385](https://github.com/jestjs/jest/pull/16385))
  162. - `[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 ([#16363](https://github.com/jestjs/jest/pull/16363))
  163. - `[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` ([#16363](https://github.com/jestjs/jest/pull/16363))
  164. - `[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 ([#16365](https://github.com/jestjs/jest/pull/16365))
  165. - `[jest-runtime]` Suspend module isolation while generating an automock, so loading the real module to read its shape no longer populates the isolated registry ([#16365](https://github.com/jestjs/jest/pull/16365))
  166. - `[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 ([#16364](https://github.com/jestjs/jest/pull/16364))
  167. - `[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 ([#16364](https://github.com/jestjs/jest/pull/16364))
  168. - `[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 ([#16364](https://github.com/jestjs/jest/pull/16364))
  169. - `[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 ([#16367](https://github.com/jestjs/jest/pull/16367))
  170. - `[jest-runtime]` Provide a CommonJS module's exports under the `'module.exports'` named export when imported from ESM, matching Node 23+ ([#16367](https://github.com/jestjs/jest/pull/16367))
  171. - `[jest-runtime]` Give the test file itself a non-null `require.main` ([#16367](https://github.com/jestjs/jest/pull/16367))
  172. - `[jest-runtime]` Populate `module.children` with the modules a file loads, matching Node ([#16368](https://github.com/jestjs/jest/pull/16368))
  173. - `[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 ([#16368](https://github.com/jestjs/jest/pull/16368))
  174. - `[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` ([#16375](https://github.com/jestjs/jest/pull/16375))
  175. - `[jest-runtime]` Share modules between overlapping graphs when a CommonJS module `require()`s an ES module mid-load, instead of evaluating shared dependencies twice ([#16375](https://github.com/jestjs/jest/pull/16375))
  176. - `[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 ([#16366](https://github.com/jestjs/jest/pull/16366))
  177. - `[jest-runtime]` Key builtin modules in the ESM registry by one canonical specifier ([#16341](https://github.com/jestjs/jest/pull/16341))
  178. - `[jest-runtime]` `import.meta.resolve()` for a builtin uses its `node:` specifier ([#16341](https://github.com/jestjs/jest/pull/16341))
  179. - `[jest-runtime]` Fall back to native ESM when a `.js` file contains ESM syntax but has no `"type":"module"` marker ([#16152](https://github.com/jestjs/jest/pull/16152))
  180. - `[jest-runtime]` Allow `require()` of ESM-marked files on Node < 24.9 via transform fallback ([#16244](https://github.com/jestjs/jest/pull/16244))
  181. - `[jest-runtime, @jest/transform]` Surface actionable `ERR_REQUIRE_ESM` error for files with untransformed ESM syntax instead of the generic "unexpected token" message ([#16244](https://github.com/jestjs/jest/pull/16244))
  182. - `[jest-runtime]` Support older test environments whose `moduleMocker` does not implement `clearMocksOnScope` ([#16169](https://github.com/jestjs/jest/pull/16169))
  183. - `[jest-runtime]` Apply `jest.unstable_mockModule` when the mocked file itself is `require()`d, not only when it is imported as a dependency ([#16389](https://github.com/jestjs/jest/pull/16389))
  184. - `[jest-runtime]` Apply `jest.unstable_mockModule` to statically imported `data:` URIs on Node 24.9+, matching dynamic `import()` ([#16389](https://github.com/jestjs/jest/pull/16389))
  185. - `[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 ([#16389](https://github.com/jestjs/jest/pull/16389))
  186. - `[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 ([#16389](https://github.com/jestjs/jest/pull/16389))
  187. - `[jest-runtime]` Strip the byte-order mark when importing a JSON module, matching `require()` and Node ([#16389](https://github.com/jestjs/jest/pull/16389))
  188. - `[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 ([#16389](https://github.com/jestjs/jest/pull/16389))
  189. - `[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 ([#16389](https://github.com/jestjs/jest/pull/16389))
  190. - `[jest-runtime]` Accept every `file:` URL string in the sandboxed `module.createRequire`, including one with a `localhost` authority, as Node does ([#16389](https://github.com/jestjs/jest/pull/16389))
  191. - `[jest-runtime]` Point at `{virtual: true}` when `jest.mock` or `jest.unstable_mockModule` is given a module that cannot be resolved ([#16389](https://github.com/jestjs/jest/pull/16389))
  192. - `[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 ([#16227](https://github.com/jestjs/jest/pull/16227))
  193. - `[jest-runtime]` Support CJS-in-ESM exports via `"module.exports"` named exports ([#16277](https://github.com/jestjs/jest/pull/16277))
  194. - `[jest-snapshot]` Keep a skipped or failed test's hinted snapshots, instead of reporting them obsolete ([#16348](https://github.com/jestjs/jest/pull/16348))
  195. - `[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` ([#16381](https://github.com/jestjs/jest/pull/16381))
  196. - `[pretty-format]` Move the `react-is` aliases into the `@jest` scope, so they cannot be shadowed by unrelated packages published under the alias names ([#16333](https://github.com/jestjs/jest/pull/16333))
  198. ## Chore & Maintenance
  200. - `[docs]` Document the intentional divergences from Node's module system in the ECMAScript Modules page ([#16368](https://github.com/jestjs/jest/pull/16368))
  201. - `[docs]` Note deprecation of `react-test-renderer` in React Native tutorial and `pretty-format` README ([#16294](https://github.com/jestjs/jest/pull/16294))
  202. - `[docs]` Use `@testing-library/react-native` in the React Native tutorial instead of the deprecated `react-test-renderer` ([#16318](https://github.com/jestjs/jest/pull/16318))
  203. - `[babel-jest, @jest/transform]` Update `babel-plugin-istanbul` to v8 ([#16049](https://github.com/jestjs/jest/pull/16049))
  204. - `[jest-config, @jest/reporters, jest-runtime]` Update `glob` to v13 ([#16397](https://github.com/jestjs/jest/pull/16397))
  205. - `[jest-haste-map]` Refactor massive class into multiple files ([#16180](https://github.com/jestjs/jest/pull/16180))
  206. - `[jest-haste-map]` Drop `walker` dependency; replace hand-rolled directory recursion in the JS crawler and watcher startup with `fdir` ([#16187](https://github.com/jestjs/jest/pull/16187))
  207. - `[jest-haste-map]` Reuse cached metadata for files whose haste name is a known duplicate, instead of re-reading and re-parsing them on every startup ([#16351](https://github.com/jestjs/jest/pull/16351))
  208. - `[jest-haste-map]` Cache the watchman socket path and replace the `watchman --version` probe with `get-sockname`, so warm runs spawn no watchman processes ([#16386](https://github.com/jestjs/jest/pull/16386))
  209. - `[jest-resolve]` Store the per-directory package-type lookup in the cache it reads, so it actually memoizes ([#16369](https://github.com/jestjs/jest/pull/16369))
  210. - `[jest-resolve, jest-runtime]` Cut repeated work on the resolution hot path: hoist the platform-extension list to construction, memoize `isCoreModule` and the options cache-key serialization, skip mapper preparation when no `moduleNameMapper` is configured, run each mapper regex once, and stop re-parsing `NODE_OPTIONS` on every default-resolver call ([#16371](https://github.com/jestjs/jest/pull/16371))
  211. - `[jest-resolve]` Cut warm resolution cost to about a third: reuse one `unrs-resolver` factory per options shape instead of cloning per resolution, compose the factory cache key from per-array cached strings instead of serializing options, and stop constructing an `Error` for misses that `findNodeModule` swallows; add a `__benchmarks__` suite for the default resolver ([#16373](https://github.com/jestjs/jest/pull/16373))
  212. - `[jest-runner, @jest/source-map]` Replace `source-map-support` with an implementation in `@jest/source-map` ([#16327](https://github.com/jestjs/jest/pull/16327))
  213. - `[jest-snapshot]` Load babel, semver and synckit lazily, so requiring the package (which every test process does through `@jest/expect`) no longer loads ~200 modules that only writing inline snapshots needs ([#16387](https://github.com/jestjs/jest/pull/16387))
  214. - `[jest-runtime]` Reduce per-require overhead: skip module ID resolution when no mock can apply, answer core modules before probing for a manual mock, share one `require.cache` proxy across modules, and cache empty files ([#16376](https://github.com/jestjs/jest/pull/16376))
  215. - `[@jest/source-map]` Deprecate `getCallsite` in favour of `SourceMapSupport#getCallsite` ([#16327](https://github.com/jestjs/jest/pull/16327))
  216. - `[jest-runtime]` Avoid magical `null` value in ESM loader ([#16160](https://github.com/jestjs/jest/pull/16160))
  218. ## New Contributors
  219. * @jon-zawada made their first contribution in https://github.com/jestjs/jest/pull/16167
  220. * @timkindberg made their first contribution in https://github.com/jestjs/jest/pull/16053
  221. * @LeSingh1 made their first contribution in https://github.com/jestjs/jest/pull/16196
  222. * @DenisBalan made their first contribution in https://github.com/jestjs/jest/pull/16192
  223. * @tsushanth made their first contribution in https://github.com/jestjs/jest/pull/16237
  224. * @jonkoops made their first contribution in https://github.com/jestjs/jest/pull/16244
  225. * @EduardF1 made their first contribution in https://github.com/jestjs/jest/pull/16268
  226. * @osfv made their first contribution in https://github.com/jestjs/jest/pull/16224
  227. * @KirtiRamchandani made their first contribution in https://github.com/jestjs/jest/pull/16211
  228. * @JasonColapietro made their first contribution in https://github.com/jestjs/jest/pull/16295
  229. * @avivkeller made their first contribution in https://github.com/jestjs/jest/pull/16277
  230. * @aojunhao123 made their first contribution in https://github.com/jestjs/jest/pull/16316
  231. * @aalhadxx made their first contribution in https://github.com/jestjs/jest/pull/16294
  232. * @christianvuerings made their first contribution in https://github.com/jestjs/jest/pull/16260
  233. * @MahinAnowar made their first contribution in https://github.com/jestjs/jest/pull/16273
  234. * @leith made their first contribution in https://github.com/jestjs/jest/pull/16049
  235. * @adi1292 made their first contribution in https://github.com/jestjs/jest/pull/16292
  236. * @soltonigiri made their first contribution in https://github.com/jestjs/jest/pull/16342
  237. * @noy-solvin made their first contribution in https://github.com/jestjs/jest/pull/16227
  238. * @skrtheboss made their first contribution in https://github.com/jestjs/jest/pull/16379
  240. **Full Changelog**: https://github.com/jestjs/jest/compare/v30.4.2...v30.5.0

auf github ansehenimported 2026-09-28 über npm