Codestin Search App

jcwatson11 · 2026-03-02T22:41:21Z

Summary

Add workerGracefulExitTimeout config option (and CLI flag) to control how long worker processes are given to exit gracefully before being force-killed
Default remains 500ms, preserving existing behavior
Touches jest-worker, jest-config, jest-runner, jest-cli, jest-schemas, and jest-types

Motivation

jest-worker hardcodes FORCE_EXIT_DELAY = 500 ms — the time workers get after all tests complete before being SIGTERM'd. Workers that don't exit in time trigger a "A worker process has failed to exit gracefully" warning. In practice, workers naturally exit in 130–500ms, so the fixed 500ms threshold causes intermittent false-positive warnings under normal load.

Making this configurable lets users tune the threshold for their environment without patching jest-worker.

Relates to #11354
Relates to #15468
Relates to #13139

Test plan

Added tests in BaseWorkerPool.test.ts verifying custom timeout is respected and default (500ms) is preserved
yarn build passes (type-check clean)
All tests pass: jest-worker (152), jest-config (266), jest-runner (15), jest-cli (6)

Add a configurable timeout for how long worker processes are given to exit gracefully before being force-killed. The previous hardcoded 500ms delay caused false-positive "failed to exit gracefully" warnings when workers naturally take close to 500ms to shut down. The new option defaults to 500 (preserving existing behavior) and can be set via jest.config.js or --workerGracefulExitTimeout CLI flag.

netlify · 2026-03-02T22:41:28Z

✅ Deploy Preview for jestjs ready!

Name	Link
🔨 Latest commit	`25afe3f`
🔍 Latest deploy log	https://app.netlify.com/projects/jestjs/deploys/69f9b30dc42ec30008c183f7
😎 Deploy Preview	https://deploy-preview-15984--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.

linux-foundation-easycla · 2026-03-02T22:41:29Z

The committers listed above are authorized under a signed CLA.

✅ login: jcwatson11 / name: Jon Watson (405d7c8, 7583c05)
✅ login: SimenB / name: Simen Bekkhus (25afe3f, 5037420)

pkg-pr-new · 2026-03-02T22:46:26Z

Open in StackBlitz

babel-jest

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

babel-plugin-jest-hoist

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

babel-preset-jest

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

create-jest

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

@jest/diff-sequences

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

expect

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

@jest/expect-utils

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

jest

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

jest-changed-files

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

jest-circus

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

jest-cli

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

jest-config

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

@jest/console

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

@jest/core

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

@jest/create-cache-key-function

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

jest-diff

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

jest-docblock

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

jest-each

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

@jest/environment

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

jest-environment-jsdom

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

@jest/environment-jsdom-abstract

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

jest-environment-node

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

@jest/expect

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

@jest/fake-timers

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

@jest/get-type

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

@jest/globals

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

jest-haste-map

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

jest-jasmine2

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

jest-leak-detector

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

jest-matcher-utils

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

jest-message-util

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

jest-mock

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

@jest/pattern

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

jest-phabricator

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

jest-regex-util

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

@jest/reporters

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

jest-resolve

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

jest-resolve-dependencies

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

jest-runner

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

jest-runtime

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

@jest/schemas

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

jest-snapshot

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

@jest/snapshot-utils

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

@jest/source-map

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

@jest/test-result

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

@jest/test-sequencer

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

@jest/transform

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

@jest/types

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

jest-util

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

jest-validate

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

jest-watcher

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

jest-worker

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

pretty-format

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

commit: 5037420

- Fix Prettier violation in jest-runner/src/index.ts - Update showConfig e2e snapshot with new config option - Revert normalize.test.ts snapshots to match CI color output

jcwatson11 · 2026-03-03T00:18:08Z

The remaining two failing checks (Windows shard 1/4 on Node v24 and Node LTS jest-jasmine2) are unrelated to this PR's changes. They fail on a snapshot in e2e/__tests__/jest.config.ts.test.ts for the on node >=24 › invalid JS in jest.config.ts (node with native TS support) test.

The issue is that the ERR_INVALID_TYPESCRIPT_SYNTAX error message format changed between Node v24 patch versions — the snapshot expects a parenthetical detail after got 'string literal' that newer builds no longer include.

Happy to include a fix in this PR (normalizing that portion of the error message in the test), but also totally understand if you'd prefer to address it separately. Just let me know!

SimenB

Thanks! Can you add it to docs/ as well?

SimenB · 2026-05-07T19:05:20Z

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))

fix: resolve CI failures for workerGracefulExitTimeout PR

7583c05

- Fix Prettier violation in jest-runner/src/index.ts - Update showConfig e2e snapshot with new config option - Revert normalize.test.ts snapshots to match CI color output

Merge branch 'main' into feat/worker-graceful-exit-timeout

5037420

SimenB approved these changes May 5, 2026

View reviewed changes

docs

25afe3f

SimenB merged commit 4b9f547 into jestjs:main May 5, 2026
5 of 9 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add workerGracefulExitTimeout config option#15984

feat: add workerGracefulExitTimeout config option#15984
SimenB merged 4 commits into
jestjs:mainfrom
jcwatson11:feat/worker-graceful-exit-timeout

jcwatson11 commented Mar 2, 2026

Uh oh!

netlify Bot commented Mar 2, 2026 •

edited

Loading

Uh oh!

linux-foundation-easycla Bot commented Mar 2, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Mar 2, 2026 •

edited

Loading

Uh oh!

jcwatson11 commented Mar 3, 2026

Uh oh!

SimenB left a comment

Uh oh!

Uh oh!

SimenB commented May 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

jcwatson11 commented Mar 2, 2026

Summary

Motivation

Test plan

Uh oh!

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

Uh oh!

✅ Deploy Preview for jestjs ready!

Uh oh!

linux-foundation-easycla Bot commented Mar 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

jcwatson11 commented Mar 3, 2026

Uh oh!

SimenB left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

SimenB commented May 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlify Bot commented Mar 2, 2026 •

edited

Loading

linux-foundation-easycla Bot commented Mar 2, 2026 •

edited

Loading

pkg-pr-new Bot commented Mar 2, 2026 •

edited

Loading