Codestin Search App

SimenB · 2026-05-05T15:57:43Z

Summary

Node 26 ships Temporal (and people can use the polyfill). So let's support it in our APIs.

Actually faking Temporal is not part of it. That's part of upstream as linked in the docs

Test plan

Tests added

netlify · 2026-05-05T15:57:49Z

✅ Deploy Preview for jestjs ready!

Name	Link
🔨 Latest commit	`021cd99`
🔍 Latest deploy log	https://app.netlify.com/projects/jestjs/deploys/69fa3095415f5300081ba1b4
😎 Deploy Preview	https://deploy-preview-16128--jestjs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot

Pull request overview

This PR adds initial Temporal interoperability to Jest’s fake-timers APIs so callers can pass Temporal-based time values without Jest attempting to fake Temporal itself. It primarily touches the public fake-timer typings, the modern fake-timers implementation, and the related tests/docs.

Changes:

Extend fake-timer APIs to accept Temporal-shaped inputs for now/setSystemTime, and Duration-shaped inputs for time advancement.
Add unit and e2e coverage for Temporal-based usage, plus lint configuration for the new e2e fixture.
Update public docs and changelog entries for the new fake-timers behavior.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
`packages/jest-types/src/Config.ts`	Widens fake-timer config typing for Temporal-shaped `now` values.
`packages/jest-fake-timers/src/modernFakeTimers.ts`	Converts Temporal-like inputs into millisecond values in modern timers.
`packages/jest-fake-timers/src/__tests__/modernFakeTimers.test.ts`	Adds unit tests for Temporal-like `now` and Duration-like advancement inputs.
`packages/jest-environment/src/index.ts`	Updates the public `Jest` interface for Temporal-aware timer APIs.
`eslint.config.mjs`	Declares `Temporal` as a global for the new e2e fixture test file.
`e2e/fake-timers-temporal/package.json`	Adds the new Temporal fake-timers e2e fixture package.
`e2e/fake-timers-temporal/__tests__/temporal.test.js`	Exercises `useFakeTimers({now})` and `setSystemTime()` with real Temporal objects.
`e2e/__tests__/fakeTimersTemporal.test.ts`	Hooks the new Temporal fixture into the e2e harness with Node-version gating.
`docs/JestObjectAPI.md`	Documents Temporal-aware fake-timer inputs and the non-faked `Temporal` caveat.
`CHANGELOG.md`	Adds a release-note entry for the new fake-timers Temporal support.

pkg-pr-new · 2026-05-05T16:32:32Z

Open in StackBlitz

babel-jest

npm i https://pkg.pr.new/babel-jest@16128

babel-plugin-jest-hoist

npm i https://pkg.pr.new/babel-plugin-jest-hoist@16128

babel-preset-jest

npm i https://pkg.pr.new/babel-preset-jest@16128

create-jest

npm i https://pkg.pr.new/create-jest@16128

@jest/diff-sequences

npm i https://pkg.pr.new/@jest/diff-sequences@16128

expect

npm i https://pkg.pr.new/expect@16128

@jest/expect-utils

npm i https://pkg.pr.new/@jest/expect-utils@16128

jest

npm i https://pkg.pr.new/jest@16128

jest-changed-files

npm i https://pkg.pr.new/jest-changed-files@16128

jest-circus

npm i https://pkg.pr.new/jest-circus@16128

jest-cli

npm i https://pkg.pr.new/jest-cli@16128

jest-config

npm i https://pkg.pr.new/jest-config@16128

@jest/console

npm i https://pkg.pr.new/@jest/console@16128

@jest/core

npm i https://pkg.pr.new/@jest/core@16128

@jest/create-cache-key-function

npm i https://pkg.pr.new/@jest/create-cache-key-function@16128

jest-diff

npm i https://pkg.pr.new/jest-diff@16128

jest-docblock

npm i https://pkg.pr.new/jest-docblock@16128

jest-each

npm i https://pkg.pr.new/jest-each@16128

@jest/environment

npm i https://pkg.pr.new/@jest/environment@16128

jest-environment-jsdom

npm i https://pkg.pr.new/jest-environment-jsdom@16128

@jest/environment-jsdom-abstract

npm i https://pkg.pr.new/@jest/environment-jsdom-abstract@16128

jest-environment-node

npm i https://pkg.pr.new/jest-environment-node@16128

@jest/expect

npm i https://pkg.pr.new/@jest/expect@16128

@jest/fake-timers

npm i https://pkg.pr.new/@jest/fake-timers@16128

@jest/get-type

npm i https://pkg.pr.new/@jest/get-type@16128

@jest/globals

npm i https://pkg.pr.new/@jest/globals@16128

jest-haste-map

npm i https://pkg.pr.new/jest-haste-map@16128

jest-jasmine2

npm i https://pkg.pr.new/jest-jasmine2@16128

jest-leak-detector

npm i https://pkg.pr.new/jest-leak-detector@16128

jest-matcher-utils

npm i https://pkg.pr.new/jest-matcher-utils@16128

jest-message-util

npm i https://pkg.pr.new/jest-message-util@16128

jest-mock

npm i https://pkg.pr.new/jest-mock@16128

@jest/pattern

npm i https://pkg.pr.new/@jest/pattern@16128

jest-phabricator

npm i https://pkg.pr.new/jest-phabricator@16128

jest-regex-util

npm i https://pkg.pr.new/jest-regex-util@16128

@jest/reporters

npm i https://pkg.pr.new/@jest/reporters@16128

jest-resolve

npm i https://pkg.pr.new/jest-resolve@16128

jest-resolve-dependencies

npm i https://pkg.pr.new/jest-resolve-dependencies@16128

jest-runner

npm i https://pkg.pr.new/jest-runner@16128

jest-runtime

npm i https://pkg.pr.new/jest-runtime@16128

@jest/schemas

npm i https://pkg.pr.new/@jest/schemas@16128

jest-snapshot

npm i https://pkg.pr.new/jest-snapshot@16128

@jest/snapshot-utils

npm i https://pkg.pr.new/@jest/snapshot-utils@16128

@jest/source-map

npm i https://pkg.pr.new/@jest/source-map@16128

@jest/test-result

npm i https://pkg.pr.new/@jest/test-result@16128

@jest/test-sequencer

npm i https://pkg.pr.new/@jest/test-sequencer@16128

@jest/transform

npm i https://pkg.pr.new/@jest/transform@16128

@jest/types

npm i https://pkg.pr.new/@jest/types@16128

jest-util

npm i https://pkg.pr.new/jest-util@16128

jest-validate

npm i https://pkg.pr.new/jest-validate@16128

jest-watcher

npm i https://pkg.pr.new/jest-watcher@16128

jest-worker

npm i https://pkg.pr.new/jest-worker@16128

pretty-format

npm i https://pkg.pr.new/pretty-format@16128

commit: 021cd99

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

+  test('useFakeTimers({now}) accepts Temporal.Instant', () => {
+    jest.useFakeTimers({now: Temporal.Instant.from(ISO)});
+    expect(Date.now()).toBe(EPOCH_MS);
+  });
+
+  test('useFakeTimers({now}) accepts Temporal.ZonedDateTime', () => {
+    const zdt = Temporal.Instant.from(ISO).toZonedDateTimeISO('UTC');
+    jest.useFakeTimers({now: zdt});


+ * LICENSE file in the root directory of this source tree.
+ */
+
+export type TemporalInstantLike = {epochMilliseconds: number};


SimenB · 2026-05-07T19:06:37Z

https://github.com/jestjs/jest/releases/tag/v30.4.0

| datasource | package | from | to | | ---------- | ------- | ------ | ------ | | npm | jest | 30.3.0 | 30.4.0 | ## [v30.4.0](https://github.com/jestjs/jest/blob/HEAD/CHANGELOG.md#3040) ##### Features - `[babel-jest]` Support collecting coverage from `.mts`, `.cts` (and other) files ([#15994](jestjs/jest#15994)) - `[jest-circus, jest-cli, jest-config, jest-core, jest-jasmine2, jest-types]` Add `--collect-tests` flag to discover and list tests without executing them ([#16006](jestjs/jest#16006)) - `[jest-config, jest-runner, jest-worker]` Add `workerGracefulExitTimeout` config option to control how long workers are given to exit before being force-killed ([#15984](jestjs/jest#15984)) - `[jest-config]` Add support for `jest.config.mts` as a valid configuration file ([#16005](jestjs/jest#16005)) - `[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 ([#16133](jestjs/jest#16133)) - `[@jest/fake-timers]` Accept `Temporal.Duration` in `jest.advanceTimersByTime()` and `jest.advanceTimersByTimeAsync()` ([#16128](jestjs/jest#16128)) - `[@jest/fake-timers]` Accept `Temporal.Instant` and `Temporal.ZonedDateTime` in `jest.setSystemTime()` and `useFakeTimers({now})` ([#16128](jestjs/jest#16128)) - `[@jest/fake-timers]` Support faking `Temporal.Now.*` ([#16131](jestjs/jest#16131)) - `[jest-mock]` Add `clearMocksOnScope(scope)` on `ModuleMocker` for clearing every mock function exposed on a scope object ([#16088](jestjs/jest#16088)) - `[jest-resolve]` Add `canResolveSync()` on `Resolver` so callers can detect when a user-configured resolver only exports an `async` hook ([#16064](jestjs/jest#16064)) - `[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 ([#16062](jestjs/jest#16062)) - `[jest-runtime]` Support `require()` of ES modules on Node v24.9+ ([#16074](jestjs/jest#16074)) - `[jest-runtime]` Validate TC39 import attributes (`with { type: 'json' }`) on ESM imports ([#16127](jestjs/jest#16127)) - `[@jest/transform]` Add `canTransformSync(filename)` on `ScriptTransformer` so callers can pick the sync vs async transform path ([#16062](jestjs/jest#16062)) - `[jest-util]` Add `isError` helper ([#16076](jestjs/jest#16076)) - `[pretty-format]` Support React 19 ([#16123](jestjs/jest#16123)) ##### Fixes - `[expect-utils]` Fix `toStrictEqual` failing on `structuredClone` results due to cross-realm constructor mismatch ([#15959](jestjs/jest#15959)) - `[@jest/expect-utils]` Prevent `toMatchObject`/subset matching from throwing when encountering exotic iterables ([#15952](jestjs/jest#15952)) - `[fake-timers]` Convert `Date` to milliseconds before passing to `@sinonjs/fake-timers` ([#16029](jestjs/jest#16029)) - `[jest]` Export `GlobalConfig` and `ProjectConfig` TypeScript types ([#16132](jestjs/jest#16132)) - `[jest-circus]` Prevent crash when `asyncError` is undefined for non-Error throws ([#16003](jestjs/jest#16003)) - `[jest-circus, jest-jasmine2]` Include `Error.cause` in JSON `failureMessages` output ([#15967](jestjs/jest#15967)) - `[jest-config]` Fix preset path resolution on Windows when the preset uses subpath `exports` ([#15961](jestjs/jest#15961)) - `[jest-config]` Allow `collectCoverage` and `coverageProvider` in project config without a validation warning ([#16132](jestjs/jest#16132)) - `[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 ([#16132](jestjs/jest#16132)) - `[jest-environment-node]` Fix `--localstorage-file` warning on Node 25+ ([#16086](jestjs/jest#16086)) - `[jest-reporters]` Apply global coverage threshold to unmatched pattern files in addition to glob/path thresholds ([#16137](jestjs/jest#16137)) - `[jest-reporters, jest-runner, jest-runtime, jest-transform]` Fix coverage report not showing correct code coverage when using `projects` config option ([#16140](jestjs/jest#16140)) - `[jest-runtime]` Resolve `expect` and `@jest/expect` from the internal module registry so test-file imports share the same `JestAssertionError` as the global `expect` ([#16130](jestjs/jest#16130)) - `[jest-runtime]` Improve CJS-from-ESM interop: `__esModule`/Babel default unwrap, broader named-export coverage, and shared CJS singleton across importers ([#16050](jestjs/jest#16050)) - `[jest-runtime]` Load `.js` files with ESM syntax but no `"type":"module"` marker as native ESM ([#16050](jestjs/jest#16050)) - `[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 ([#16078](jestjs/jest#16078)) - `[jest-runtime]` Fix deadlocks and double-evaluation in concurrent ESM and wasm imports ([#16050](jestjs/jest#16050)) - `[jest-runtime]` Fix error when `require()` is called after the Jest environment has been torn down ([#15951](jestjs/jest#15951)) - `[jest-runtime]` Fix missing error when `import()` is called after the Jest environment has been torn down ([#16080](jestjs/jest#16080)) - `[jest-runtime]` Fix virtual `unstable_mockModule` registrations not respected in ESM ([#16081](jestjs/jest#16081)) - `[jest-runtime]` Apply `moduleNameMapper` when resolving modules with `require.resolve()` and the `paths` option ([#16135](jestjs/jest#16135)) ##### Chore & Maintenance - `[@jest/fake-timers]` Upgrade `@sinonjs/fake-timers` ([#16139](jestjs/jest#16139)) - `[jest-runtime]` Use synchronous `linkRequests` / `instantiate` for ESM linking on Node v24.9+ ([#16063](jestjs/jest#16063))

| datasource | package | from | to | | ---------- | ------- | ------ | ------ | | npm | jest | 30.3.0 | 30.4.2 | ## [v30.4.2](https://github.com/jestjs/jest/blob/HEAD/CHANGELOG.md#3042) ##### Fixes - `[jest-runtime]` Fix named imports from CJS modules whose `module.exports` is a function with own-property exports ([#16150](jestjs/jest#16150)) ## [v30.4.1](https://github.com/jestjs/jest/blob/HEAD/CHANGELOG.md#3041) ##### Features - `[jest-config, jest-core, jest-runner, jest-schemas, jest-types]` Allow custom runner configuration options via tuple format `['runner-path', {options}]` ([#16141](jestjs/jest#16141)) ##### Fixes - `[jest-runtime]` Align CJS-from-ESM default export with Node: `module.exports` is always the ESM default, `__esModule` unwrapping is no longer applied ([#16143](jestjs/jest#16143)) ## [v30.4.0](https://github.com/jestjs/jest/blob/HEAD/CHANGELOG.md#3040) ##### Features - `[babel-jest]` Support collecting coverage from `.mts`, `.cts` (and other) files ([#15994](jestjs/jest#15994)) - `[jest-circus, jest-cli, jest-config, jest-core, jest-jasmine2, jest-types]` Add `--collect-tests` flag to discover and list tests without executing them ([#16006](jestjs/jest#16006)) - `[jest-config, jest-runner, jest-worker]` Add `workerGracefulExitTimeout` config option to control how long workers are given to exit before being force-killed ([#15984](jestjs/jest#15984)) - `[jest-config]` Add support for `jest.config.mts` as a valid configuration file ([#16005](jestjs/jest#16005)) - `[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 ([#16133](jestjs/jest#16133)) - `[@jest/fake-timers]` Accept `Temporal.Duration` in `jest.advanceTimersByTime()` and `jest.advanceTimersByTimeAsync()` ([#16128](jestjs/jest#16128)) - `[@jest/fake-timers]` Accept `Temporal.Instant` and `Temporal.ZonedDateTime` in `jest.setSystemTime()` and `useFakeTimers({now})` ([#16128](jestjs/jest#16128)) - `[@jest/fake-timers]` Support faking `Temporal.Now.*` ([#16131](jestjs/jest#16131)) - `[jest-mock]` Add `clearMocksOnScope(scope)` on `ModuleMocker` for clearing every mock function exposed on a scope object ([#16088](jestjs/jest#16088)) - `[jest-resolve]` Add `canResolveSync()` on `Resolver` so callers can detect when a user-configured resolver only exports an `async` hook ([#16064](jestjs/jest#16064)) - `[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 ([#16062](jestjs/jest#16062)) - `[jest-runtime]` Support `require()` of ES modules on Node v24.9+ ([#16074](jestjs/jest#16074)) - `[jest-runtime]` Validate TC39 import attributes (`with { type: 'json' }`) on ESM imports ([#16127](jestjs/jest#16127)) - `[@jest/transform]` Add `canTransformSync(filename)` on `ScriptTransformer` so callers can pick the sync vs async transform path ([#16062](jestjs/jest#16062)) - `[jest-util]` Add `isError` helper ([#16076](jestjs/jest#16076)) - `[pretty-format]` Support React 19 ([#16123](jestjs/jest#16123)) ##### Fixes - `[expect-utils]` Fix `toStrictEqual` failing on `structuredClone` results due to cross-realm constructor mismatch ([#15959](jestjs/jest#15959)) - `[@jest/expect-utils]` Prevent `toMatchObject`/subset matching from throwing when encountering exotic iterables ([#15952](jestjs/jest#15952)) - `[fake-timers]` Convert `Date` to milliseconds before passing to `@sinonjs/fake-timers` ([#16029](jestjs/jest#16029)) - `[jest]` Export `GlobalConfig` and `ProjectConfig` TypeScript types ([#16132](jestjs/jest#16132)) - `[jest-circus]` Prevent crash when `asyncError` is undefined for non-Error throws ([#16003](jestjs/jest#16003)) - `[jest-circus, jest-jasmine2]` Include `Error.cause` in JSON `failureMessages` output ([#15967](jestjs/jest#15967)) - `[jest-config]` Fix preset path resolution on Windows when the preset uses subpath `exports` ([#15961](jestjs/jest#15961)) - `[jest-config]` Allow `collectCoverage` and `coverageProvider` in project config without a validation warning ([#16132](jestjs/jest#16132)) - `[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 ([#16132](jestjs/jest#16132)) - `[jest-environment-node]` Fix `--localstorage-file` warning on Node 25+ ([#16086](jestjs/jest#16086)) - `[jest-reporters]` Apply global coverage threshold to unmatched pattern files in addition to glob/path thresholds ([#16137](jestjs/jest#16137)) - `[jest-reporters, jest-runner, jest-runtime, jest-transform]` Fix coverage report not showing correct code coverage when using `projects` config option ([#16140](jestjs/jest#16140)) - `[jest-runtime]` Resolve `expect` and `@jest/expect` from the internal module registry so test-file imports share the same `JestAssertionError` as the global `expect` ([#16130](jestjs/jest#16130)) - `[jest-runtime]` Improve CJS-from-ESM interop: `__esModule`/Babel default unwrap, broader named-export coverage, and shared CJS singleton across importers ([#16050](jestjs/jest#16050)) - `[jest-runtime]` Load `.js` files with ESM syntax but no `"type":"module"` marker as native ESM ([#16050](jestjs/jest#16050)) - `[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 ([#16078](jestjs/jest#16078)) - `[jest-runtime]` Fix deadlocks and double-evaluation in concurrent ESM and wasm imports ([#16050](jestjs/jest#16050)) - `[jest-runtime]` Fix error when `require()` is called after the Jest environment has been torn down ([#15951](jestjs/jest#15951)) - `[jest-runtime]` Fix missing error when `import()` is called after the Jest environment has been torn down ([#16080](jestjs/jest#16080)) - `[jest-runtime]` Fix virtual `unstable_mockModule` registrations not respected in ESM ([#16081](jestjs/jest#16081)) - `[jest-runtime]` Apply `moduleNameMapper` when resolving modules with `require.resolve()` and the `paths` option ([#16135](jestjs/jest#16135)) ##### Chore & Maintenance - `[@jest/fake-timers]` Upgrade `@sinonjs/fake-timers` ([#16139](jestjs/jest#16139)) - `[jest-runtime]` Use synchronous `linkRequests` / `instantiate` for ESM linking on Node v24.9+ ([#16063](jestjs/jest#16063))

feat(fake-timers): basic support for Temporal

fce24a0

Copilot AI review requested due to automatic review settings May 5, 2026 15:57

Copilot started reviewing on behalf of SimenB May 5, 2026 15:58 View session

changelog

ba04969

Copilot AI reviewed May 5, 2026

View reviewed changes

address review

ae6126a

fix ci

bc221e7

SimenB requested a review from Copilot May 5, 2026 16:36

Copilot started reviewing on behalf of SimenB May 5, 2026 16:37 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

SimenB requested a review from Copilot May 5, 2026 17:35

Copilot started reviewing on behalf of SimenB May 5, 2026 17:36 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

SimenB added 3 commits May 5, 2026 19:50

type tests

fb4b089

oops

06d3c26

review comments

021cd99

SimenB merged commit 9b1171f into jestjs:main May 5, 2026
90 checks passed

SimenB deleted the temporal branch May 5, 2026 18:33

snowystinger mentioned this pull request May 14, 2026

chore: upgrade Jest 30 adobe/react-spectrum#10067

Open

5 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(fake-timers): basic support for `Temporal`#16128

feat(fake-timers): basic support for `Temporal`#16128
SimenB merged 7 commits into
jestjs:mainfrom
SimenB:temporal

SimenB commented May 5, 2026

Uh oh!

netlify Bot commented May 5, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pkg-pr-new Bot commented May 5, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

SimenB commented May 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

SimenB commented May 5, 2026

Summary

Test plan

Uh oh!

netlify Bot commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for jestjs ready!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pkg-pr-new Bot commented May 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

SimenB commented May 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlify Bot commented May 5, 2026 •

edited

Loading

pkg-pr-new Bot commented May 5, 2026 •

edited

Loading