docs

SimenB · SimenB · commit 25afe3fd0d51 · 2026-05-05T11:05:53.000+02:00
diff --git a/docs/CLI.md b/docs/CLI.md
@@ -571,6 +571,10 @@ Use `--no-watchAll` (or `--watchAll=false`) to explicitly disable the watch mode
 
 Whether to use [`watchman`](https://facebook.github.io/watchman/) for file crawling. Defaults to `true`. Disable using `--no-watchman`.
 
+### `--workerGracefulExitTimeout=<number>`
+
+Timeout in milliseconds for worker processes to exit gracefully after tests complete. Workers that do not exit in time are force-killed. Default: `500`.
+
 ### `--workerThreads`
 
 Whether to use [worker threads](https://nodejs.org/dist/latest/docs/api/worker_threads.html) for parallelization. [Child processes](https://nodejs.org/dist/latest/docs/api/child_process.html) are used by default.
diff --git a/docs/Configuration.md b/docs/Configuration.md
@@ -2483,6 +2483,30 @@ Default: `true`
 
 Whether to use [`watchman`](https://facebook.github.io/watchman/) for file crawling.
 
+### `workerGracefulExitTimeout` \[number]
+
+Default: `500`
+
+Timeout in milliseconds for a worker process to exit gracefully after all tests have completed. If a worker does not exit within this timeout, it is force-killed.
+
+Increase this value if your test environment requires more time to tear down (for example, when using `--detectOpenHandles` or when workers hold onto long-lived resources).
+
+```js tab title="jest.config.js"
+const {defineConfig} = require('jest');
+
+module.exports = defineConfig({
+  workerGracefulExitTimeout: 2000,
+});
+```
+
+```ts tab title="jest.config.ts"
+import {defineConfig} from 'jest';
+
+export default defineConfig({
+  workerGracefulExitTimeout: 2000,
+});
+```
+
 ### `workerIdleMemoryLimit` \[number|string]
 
 Default: `undefined`
