@types/node 20.19.25 → 24.10.4

{node v20.19 → node v24.10}/test.d.ts

@@ -10,7 +10,7 @@
  * work:
  *
  * ```js
- * import test from 'test';
+ * import test from 'node:test';
  * ```
  *
  * Tests created via the `test` module consist of a single function that is
@@ -76,7 +76,7 @@
  *
  * If any tests fail, the process exit code is set to `1`.
  * @since v18.0.0, v16.17.0
- * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/test.js)
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/test.js)
  */
 declare module "node:test" {
     import { AssertMethodNames } from "node:assert";
@@ -240,9 +240,17 @@ declare module "node:test" {
              * @default false
              */
             concurrency?: number | boolean | undefined;
+            /**
+             * Specifies the current working directory to be used by the test runner.
+             * Serves as the base path for resolving files according to the
+             * [test runner execution model](https://nodejs.org/docs/latest-v24.x/api/test.html#test-runner-execution-model).
+             * @since v23.0.0
+             * @default process.cwd()
+             */
+            cwd?: string | undefined;
             /**
              * An array containing the list of files to run. If omitted, files are run according to the
-             * [test runner execution model](https://nodejs.org/docs/latest-v20.x/api/test.html#test-runner-execution-model).
+             * [test runner execution model](https://nodejs.org/docs/latest-v24.x/api/test.html#test-runner-execution-model).
              */
             files?: readonly string[] | undefined;
             /**
@@ -252,13 +260,31 @@ declare module "node:test" {
              * @default false
              */
             forceExit?: boolean | undefined;
+            /**
+             * An array containing the list of glob patterns to match test files.
+             * This option cannot be used together with `files`. If omitted, files are run according to the
+             * [test runner execution model](https://nodejs.org/docs/latest-v24.x/api/test.html#test-runner-execution-model).
+             * @since v22.6.0
+             */
+            globPatterns?: readonly string[] | undefined;
             /**
              * Sets inspector port of test child process.
-             * If a nullish value is provided, each process gets its own port,
-             * incremented from the primary's `process.debugPort`.
+             * This can be a number, or a function that takes no arguments and returns a
+             * number. If a nullish value is provided, each process gets its own port,
+             * incremented from the primary's `process.debugPort`. This option is ignored
+             * if the `isolation` option is set to `'none'` as no child processes are
+             * spawned.
              * @default undefined
              */
             inspectPort?: number | (() => number) | undefined;
+            /**
+             * Configures the type of test isolation. If set to
+             * `'process'`, each test file is run in a separate child process. If set to
+             * `'none'`, all test files run in the current process.
+             * @default 'process'
+             * @since v22.8.0
+             */
+            isolation?: "process" | "none" | undefined;
             /**
              * If truthy, the test context will only run tests that have the `only` option set
              */
@@ -268,6 +294,20 @@ declare module "node:test" {
              * @default undefined
              */
             setup?: ((reporter: TestsStream) => void | Promise<void>) | undefined;
+            /**
+             * An array of CLI flags to pass to the `node` executable when
+             * spawning the subprocesses. This option has no effect when `isolation` is `'none`'.
+             * @since v22.10.0
+             * @default []
+             */
+            execArgv?: readonly string[] | undefined;
+            /**
+             * An array of CLI flags to pass to each test file when spawning the
+             * subprocesses. This option has no effect when `isolation` is `'none'`.
+             * @since v22.10.0
+             * @default []
+             */
+            argv?: readonly string[] | undefined;
             /**
              * Allows aborting an in-progress test execution.
              */
@@ -278,6 +318,15 @@ declare module "node:test" {
              * @default undefined
              */
             testNamePatterns?: string | RegExp | ReadonlyArray<string | RegExp> | undefined;
+            /**
+             * A String, RegExp or a RegExp Array, that can be used to exclude running tests whose
+             * name matches the provided pattern. Test name patterns are interpreted as JavaScript
+             * regular expressions. For each test that is executed, any corresponding test hooks,
+             * such as `beforeEach()`, are also run.
+             * @default undefined
+             * @since v22.1.0
+             */
+            testSkipPatterns?: string | RegExp | ReadonlyArray<string | RegExp> | undefined;
             /**
              * The number of milliseconds after which the test execution will fail.
              * If unspecified, subtests inherit this value from their parent.
@@ -294,6 +343,60 @@ declare module "node:test" {
              * @default undefined
              */
             shard?: TestShard | undefined;
+            /**
+             * A file path where the test runner will
+             * store the state of the tests to allow rerunning only the failed tests on a next run.
+             * @since v24.7.0
+             * @default undefined
+             */
+            rerunFailuresFilePath?: string | undefined;
+            /**
+             * enable [code coverage](https://nodejs.org/docs/latest-v24.x/api/test.html#collecting-code-coverage) collection.
+             * @since v22.10.0
+             * @default false
+             */
+            coverage?: boolean | undefined;
+            /**
+             * Excludes specific files from code coverage
+             * using a glob pattern, which can match both absolute and relative file paths.
+             * This property is only applicable when `coverage` was set to `true`.
+             * If both `coverageExcludeGlobs` and `coverageIncludeGlobs` are provided,
+             * files must meet **both** criteria to be included in the coverage report.
+             * @since v22.10.0
+             * @default undefined
+             */
+            coverageExcludeGlobs?: string | readonly string[] | undefined;
+            /**
+             * Includes specific files in code coverage
+             * using a glob pattern, which can match both absolute and relative file paths.
+             * This property is only applicable when `coverage` was set to `true`.
+             * If both `coverageExcludeGlobs` and `coverageIncludeGlobs` are provided,
+             * files must meet **both** criteria to be included in the coverage report.
+             * @since v22.10.0
+             * @default undefined
+             */
+            coverageIncludeGlobs?: string | readonly string[] | undefined;
+            /**
+             * Require a minimum percent of covered lines. If code
+             * coverage does not reach the threshold specified, the process will exit with code `1`.
+             * @since v22.10.0
+             * @default 0
+             */
+            lineCoverage?: number | undefined;
+            /**
+             * Require a minimum percent of covered branches. If code
+             * coverage does not reach the threshold specified, the process will exit with code `1`.
+             * @since v22.10.0
+             * @default 0
+             */
+            branchCoverage?: number | undefined;
+            /**
+             * Require a minimum percent of covered functions. If code
+             * coverage does not reach the threshold specified, the process will exit with code `1`.
+             * @since v22.10.0
+             * @default 0
+             */
+            functionCoverage?: number | undefined;
         }
         /**
          * A successful call to `run()` will return a new `TestsStream` object, streaming a series of events representing the execution of the tests.
@@ -313,7 +416,9 @@ declare module "node:test" {
             addListener(event: "test:start", listener: (data: EventData.TestStart) => void): this;
             addListener(event: "test:stderr", listener: (data: EventData.TestStderr) => void): this;
             addListener(event: "test:stdout", listener: (data: EventData.TestStdout) => void): this;
+            addListener(event: "test:summary", listener: (data: EventData.TestSummary) => void): this;
             addListener(event: "test:watch:drained", listener: () => void): this;
+            addListener(event: "test:watch:restarted", listener: () => void): this;
             addListener(event: string, listener: (...args: any[]) => void): this;
             emit(event: "test:coverage", data: EventData.TestCoverage): boolean;
             emit(event: "test:complete", data: EventData.TestComplete): boolean;
@@ -326,7 +431,9 @@ declare module "node:test" {
             emit(event: "test:start", data: EventData.TestStart): boolean;
             emit(event: "test:stderr", data: EventData.TestStderr): boolean;
             emit(event: "test:stdout", data: EventData.TestStdout): boolean;
+            emit(event: "test:summary", data: EventData.TestSummary): boolean;
             emit(event: "test:watch:drained"): boolean;
+            emit(event: "test:watch:restarted"): boolean;
             emit(event: string | symbol, ...args: any[]): boolean;
             on(event: "test:coverage", listener: (data: EventData.TestCoverage) => void): this;
             on(event: "test:complete", listener: (data: EventData.TestComplete) => void): this;
@@ -339,7 +446,9 @@ declare module "node:test" {
             on(event: "test:start", listener: (data: EventData.TestStart) => void): this;
             on(event: "test:stderr", listener: (data: EventData.TestStderr) => void): this;
             on(event: "test:stdout", listener: (data: EventData.TestStdout) => void): this;
+            on(event: "test:summary", listener: (data: EventData.TestSummary) => void): this;
             on(event: "test:watch:drained", listener: () => void): this;
+            on(event: "test:watch:restarted", listener: () => void): this;
             on(event: string, listener: (...args: any[]) => void): this;
             once(event: "test:coverage", listener: (data: EventData.TestCoverage) => void): this;
             once(event: "test:complete", listener: (data: EventData.TestComplete) => void): this;
@@ -352,7 +461,9 @@ declare module "node:test" {
             once(event: "test:start", listener: (data: EventData.TestStart) => void): this;
             once(event: "test:stderr", listener: (data: EventData.TestStderr) => void): this;
             once(event: "test:stdout", listener: (data: EventData.TestStdout) => void): this;
+            once(event: "test:summary", listener: (data: EventData.TestSummary) => void): this;
             once(event: "test:watch:drained", listener: () => void): this;
+            once(event: "test:watch:restarted", listener: () => void): this;
             once(event: string, listener: (...args: any[]) => void): this;
             prependListener(event: "test:coverage", listener: (data: EventData.TestCoverage) => void): this;
             prependListener(event: "test:complete", listener: (data: EventData.TestComplete) => void): this;
@@ -365,7 +476,9 @@ declare module "node:test" {
             prependListener(event: "test:start", listener: (data: EventData.TestStart) => void): this;
             prependListener(event: "test:stderr", listener: (data: EventData.TestStderr) => void): this;
             prependListener(event: "test:stdout", listener: (data: EventData.TestStdout) => void): this;
+            prependListener(event: "test:summary", listener: (data: EventData.TestSummary) => void): this;
             prependListener(event: "test:watch:drained", listener: () => void): this;
+            prependListener(event: "test:watch:restarted", listener: () => void): this;
             prependListener(event: string, listener: (...args: any[]) => void): this;
             prependOnceListener(event: "test:coverage", listener: (data: EventData.TestCoverage) => void): this;
             prependOnceListener(event: "test:complete", listener: (data: EventData.TestComplete) => void): this;
@@ -378,7 +491,9 @@ declare module "node:test" {
             prependOnceListener(event: "test:start", listener: (data: EventData.TestStart) => void): this;
             prependOnceListener(event: "test:stderr", listener: (data: EventData.TestStderr) => void): this;
             prependOnceListener(event: "test:stdout", listener: (data: EventData.TestStdout) => void): this;
+            prependOnceListener(event: "test:summary", listener: (data: EventData.TestSummary) => void): this;
             prependOnceListener(event: "test:watch:drained", listener: () => void): this;
+            prependOnceListener(event: "test:watch:restarted", listener: () => void): this;
             prependOnceListener(event: string, listener: (...args: any[]) => void): this;
         }
         namespace EventData {
@@ -409,6 +524,14 @@ declare module "node:test" {
                  * The nesting level of the test.
                  */
                 nesting: number;
+                /**
+                 * The severity level of the diagnostic message.
+                 * Possible values are:
+                 * * `'info'`: Informational messages.
+                 * * `'warn'`: Warnings.
+                 * * `'error'`: Errors.
+                 */
+                level: "info" | "warn" | "error";
             }
             interface TestCoverage {
                 /**
@@ -503,6 +626,25 @@ declare module "node:test" {
                             count: number;
                         }>;
                     }>;
+                    /**
+                     * An object containing whether or not the coverage for
+                     * each coverage type.
+                     * @since v22.9.0
+                     */
+                    thresholds: {
+                        /**
+                         * The function coverage threshold.
+                         */
+                        function: number;
+                        /**
+                         * The branch coverage threshold.
+                         */
+                        branch: number;
+                        /**
+                         * The line coverage threshold.
+                         */
+                        line: number;
+                    };
                     /**
                      * An object containing a summary of coverage for all files.
                      */
@@ -576,7 +718,7 @@ declare module "node:test" {
                     /**
                      * The type of the test, used to denote whether this is a suite.
                      */
-                    type?: "suite";
+                    type?: "suite" | "test";
                 };
                 /**
                  * The test name.
@@ -608,6 +750,11 @@ declare module "node:test" {
                  * The nesting level of the test.
                  */
                 nesting: number;
+                /**
+                 * The test type. Either `'suite'` or `'test'`.
+                 * @since v22.15.0
+                 */
+                type: "suite" | "test";
             }
             interface TestEnqueue extends LocationInfo {
                 /**
@@ -618,6 +765,11 @@ declare module "node:test" {
                  * The nesting level of the test.
                  */
                 nesting: number;
+                /**
+                 * The test type. Either `'suite'` or `'test'`.
+                 * @since v22.15.0
+                 */
+                type: "suite" | "test";
             }
             interface TestFail extends LocationInfo {
                 /**
@@ -636,7 +788,13 @@ declare module "node:test" {
                      * The type of the test, used to denote whether this is a suite.
                      * @since v20.0.0, v19.9.0, v18.17.0
                      */
-                    type?: "suite";
+                    type?: "suite" | "test";
+                    /**
+                     * The attempt number of the test run,
+                     * present only when using the `--test-rerun-failures` flag.
+                     * @since v24.7.0
+                     */
+                    attempt?: number;
                 };
                 /**
                  * The test name.
@@ -672,7 +830,19 @@ declare module "node:test" {
                      * The type of the test, used to denote whether this is a suite.
                      * @since 20.0.0, 19.9.0, 18.17.0
                      */
-                    type?: "suite";
+                    type?: "suite" | "test";
+                    /**
+                     * The attempt number of the test run,
+                     * present only when using the `--test-rerun-failures` flag.
+                     * @since v24.7.0
+                     */
+                    attempt?: number;
+                    /**
+                     * The attempt number the test passed on,
+                     * present only when using the `--test-rerun-failures` flag.
+                     * @since v24.7.0
+                     */
+                    passed_on_attempt?: number;
                 };
                 /**
                  * The test name.
@@ -735,6 +905,57 @@ declare module "node:test" {
                  */
                 message: string;
             }
+            interface TestSummary {
+                /**
+                 * An object containing the counts of various test results.
+                 */
+                counts: {
+                    /**
+                     * The total number of cancelled tests.
+                     */
+                    cancelled: number;
+                    /**
+                     * The total number of passed tests.
+                     */
+                    passed: number;
+                    /**
+                     * The total number of skipped tests.
+                     */
+                    skipped: number;
+                    /**
+                     * The total number of suites run.
+                     */
+                    suites: number;
+                    /**
+                     * The total number of tests run, excluding suites.
+                     */
+                    tests: number;
+                    /**
+                     * The total number of TODO tests.
+                     */
+                    todo: number;
+                    /**
+                     * The total number of top level tests and suites.
+                     */
+                    topLevel: number;
+                };
+                /**
+                 * The duration of the test run in milliseconds.
+                 */
+                duration_ms: number;
+                /**
+                 * The path of the test file that generated the
+                 * summary. If the summary corresponds to multiple files, this value is
+                 * `undefined`.
+                 */
+                file: string | undefined;
+                /**
+                 * Indicates whether or not the test run is considered
+                 * successful or not. If any error condition occurs, such as a failing test or
+                 * unmet coverage threshold, this value will be set to `false`.
+                 */
+                success: boolean;
+            }
         }
         /**
          * An instance of `TestContext` is passed to each test function in order to
@@ -763,9 +984,10 @@ declare module "node:test" {
              *   t.assert.deepStrictEqual(actual, expected); // Error: 't' needs an explicit type annotation.
              * });
              * ```
-             * @since v20.15.0
+             * @since v22.2.0, v20.15.0
              */
             readonly assert: TestContextAssert;
+            readonly attempt: number;
             /**
              * This function is used to create a hook running before subtest of the current test.
              * @param fn The hook function. The first argument to this function is a `TestContext` object.
@@ -812,9 +1034,15 @@ declare module "node:test" {
              * @param message Message to be reported.
              */
             diagnostic(message: string): void;
+            /**
+             * The absolute path of the test file that created the current test. If a test file imports
+             * additional modules that generate tests, the imported tests will return the path of the root test file.
+             * @since v22.6.0
+             */
+            readonly filePath: string | undefined;
             /**
              * The name of the test and each of its ancestors, separated by `>`.
-             * @since v20.16.0
+             * @since v22.3.0
              */
             readonly fullName: string;
             /**
@@ -823,11 +1051,12 @@ declare module "node:test" {
              */
             readonly name: string;
             /**
-             * Used to set the number of assertions and subtests that are expected to run within the test.
-             * If the number of assertions and subtests that run does not match the expected count, the test will fail.
+             * This function is used to set the number of assertions and subtests that are expected to run
+             * within the test. If the number of assertions and subtests that run does not match the
+             * expected count, the test will fail.
+             *
+             * > Note: To make sure assertions are tracked, `t.assert` must be used instead of `assert` directly.
              *
-             * To make sure assertions are tracked, the assert functions on `context.assert` must be used,
-             * instead of importing from the `node:assert` module.
              * ```js
              * test('top level test', (t) => {
              *   t.plan(2);
@@ -836,7 +1065,9 @@ declare module "node:test" {
              * });
              * ```
              *
-             * When working with asynchronous code, the `plan` function can be used to ensure that the correct number of assertions are run:
+             * When working with asynchronous code, the `plan` function can be used to ensure that the
+             * correct number of assertions are run:
+             *
              * ```js
              * test('planning with streams', (t, done) => {
              *   function* generate() {
@@ -850,14 +1081,35 @@ declare module "node:test" {
              *   stream.on('data', (chunk) => {
              *     t.assert.strictEqual(chunk, expected.shift());
              *   });
+             *
              *   stream.on('end', () => {
              *     done();
              *   });
              * });
              * ```
-             * @since v20.15.0
+             *
+             * When using the `wait` option, you can control how long the test will wait for the expected assertions.
+             * For example, setting a maximum wait time ensures that the test will wait for asynchronous assertions
+             * to complete within the specified timeframe:
+             *
+             * ```js
+             * test('plan with wait: 2000 waits for async assertions', (t) => {
+             *   t.plan(1, { wait: 2000 }); // Waits for up to 2 seconds for the assertion to complete.
+             *
+             *   const asyncActivity = () => {
+             *     setTimeout(() => {
+             *          *       t.assert.ok(true, 'Async assertion completed within the wait time');
+             *     }, 1000); // Completes after 1 second, within the 2-second wait time.
+             *   };
+             *
+             *   asyncActivity(); // The test will pass because the assertion is completed in time.
+             * });
+             * ```
+             *
+             * Note: If a `wait` timeout is specified, it begins counting down only after the test function finishes executing.
+             * @since v22.2.0
              */
-            plan(count: number): void;
+            plan(count: number, options?: TestContextPlanOptions): void;
             /**
              * If `shouldRunOnlyTests` is truthy, the test context will only run tests that
              * have the `only` option set. Otherwise, all tests are run. If Node.js was not
@@ -929,12 +1181,116 @@ declare module "node:test" {
              * @returns A {@link Promise} resolved with `undefined` once the test completes.
              */
             test: typeof test;
+            /**
+             * This method polls a `condition` function until that function either returns
+             * successfully or the operation times out.
+             * @since v22.14.0
+             * @param condition An assertion function that is invoked
+             * periodically until it completes successfully or the defined polling timeout
+             * elapses. Successful completion is defined as not throwing or rejecting. This
+             * function does not accept any arguments, and is allowed to return any value.
+             * @param options An optional configuration object for the polling operation.
+             * @returns Fulfilled with the value returned by `condition`.
+             */
+            waitFor<T>(condition: () => T, options?: TestContextWaitForOptions): Promise<Awaited<T>>;
             /**
              * Each test provides its own MockTracker instance.
              */
             readonly mock: MockTracker;
         }
-        interface TestContextAssert extends Pick<typeof import("assert"), AssertMethodNames> {}
+        interface TestContextAssert extends Pick<typeof import("assert"), AssertMethodNames> {
+            /**
+             * This function serializes `value` and writes it to the file specified by `path`.
+             *
+             * ```js
+             * test('snapshot test with default serialization', (t) => {
+             *   t.assert.fileSnapshot({ value1: 1, value2: 2 }, './snapshots/snapshot.json');
+             * });
+             * ```
+             *
+             * This function differs from `context.assert.snapshot()` in the following ways:
+             *
+             * * The snapshot file path is explicitly provided by the user.
+             * * Each snapshot file is limited to a single snapshot value.
+             * * No additional escaping is performed by the test runner.
+             *
+             * These differences allow snapshot files to better support features such as syntax
+             * highlighting.
+             * @since v22.14.0
+             * @param value A value to serialize to a string. If Node.js was started with
+             * the [`--test-update-snapshots`](https://nodejs.org/docs/latest-v24.x/api/cli.html#--test-update-snapshots)
+             * flag, the serialized value is written to
+             * `path`. Otherwise, the serialized value is compared to the contents of the
+             * existing snapshot file.
+             * @param path The file where the serialized `value` is written.
+             * @param options Optional configuration options.
+             */
+            fileSnapshot(value: any, path: string, options?: AssertSnapshotOptions): void;
+            /**
+             * This function implements assertions for snapshot testing.
+             * ```js
+             * test('snapshot test with default serialization', (t) => {
+             *   t.assert.snapshot({ value1: 1, value2: 2 });
+             * });
+             *
+             * test('snapshot test with custom serialization', (t) => {
+             *   t.assert.snapshot({ value3: 3, value4: 4 }, {
+             *     serializers: [(value) => JSON.stringify(value)]
+             *   });
+             * });
+             * ```
+             * @since v22.3.0
+             * @param value A value to serialize to a string. If Node.js was started with
+             * the [`--test-update-snapshots`](https://nodejs.org/docs/latest-v24.x/api/cli.html#--test-update-snapshots)
+             * flag, the serialized value is written to
+             * the snapshot file. Otherwise, the serialized value is compared to the
+             * corresponding value in the existing snapshot file.
+             */
+            snapshot(value: any, options?: AssertSnapshotOptions): void;
+            /**
+             * A custom assertion function registered with `assert.register()`.
+             */
+            [name: string]: (...args: any[]) => void;
+        }
+        interface AssertSnapshotOptions {
+            /**
+             * An array of synchronous functions used to serialize `value` into a string.
+             * `value` is passed as the only argument to the first serializer function.
+             * The return value of each serializer is passed as input to the next serializer.
+             * Once all serializers have run, the resulting value is coerced to a string.
+             *
+             * If no serializers are provided, the test runner's default serializers are used.
+             */
+            serializers?: ReadonlyArray<(value: any) => any> | undefined;
+        }
+        interface TestContextPlanOptions {
+            /**
+             * The wait time for the plan:
+             * * If `true`, the plan waits indefinitely for all assertions and subtests to run.
+             * * If `false`, the plan performs an immediate check after the test function completes,
+             * without waiting for any pending assertions or subtests.
+             * Any assertions or subtests that complete after this check will not be counted towards the plan.
+             * * If a number, it specifies the maximum wait time in milliseconds
+             * before timing out while waiting for expected assertions and subtests to be matched.
+             * If the timeout is reached, the test will fail.
+             * @default false
+             */
+            wait?: boolean | number | undefined;
+        }
+        interface TestContextWaitForOptions {
+            /**
+             * The number of milliseconds to wait after an unsuccessful
+             * invocation of `condition` before trying again.
+             * @default 50
+             */
+            interval?: number | undefined;
+            /**
+             * The poll timeout in milliseconds. If `condition` has not
+             * succeeded by the time this elapses, an error occurs.
+             * @default 1000
+             */
+            timeout?: number | undefined;
+        }
         /**
          * An instance of `SuiteContext` is passed to each suite function in order to
          * interact with the test runner. However, the `SuiteContext` constructor is not
@@ -942,6 +1298,12 @@ declare module "node:test" {
          * @since v18.7.0, v16.17.0
          */
         interface SuiteContext {
+            /**
+             * The absolute path of the test file that created the current suite. If a test file imports
+             * additional modules that generate suites, the imported suites will return the path of the root test file.
+             * @since v22.6.0
+             */
+            readonly filePath: string | undefined;
             /**
              * The name of the suite.
              * @since v18.8.0, v16.18.0
@@ -998,7 +1360,7 @@ declare module "node:test" {
              * If the number of assertions run in the test does not match the number
              * specified in the plan, the test will fail.
              * @default undefined
-             * @since v20.15.0
+             * @since v22.2.0
              */
             plan?: number | undefined;
         }
@@ -1307,16 +1669,89 @@ declare module "node:test" {
                 options?: MockFunctionOptions,
             ): Mock<((value: MockedObject[MethodName]) => void) | Implementation>;
             /**
-             * This function is used to mock the exports of ECMAScript modules, CommonJS modules, and Node.js builtin modules.
-             * Any references to the original module prior to mocking are not impacted.
+             * This function is used to mock the exports of ECMAScript modules, CommonJS modules, JSON modules, and
+             * Node.js builtin modules. Any references to the original module prior to mocking are not impacted. In
+             * order to enable module mocking, Node.js must be started with the
+             * [`--experimental-test-module-mocks`](https://nodejs.org/docs/latest-v24.x/api/cli.html#--experimental-test-module-mocks)
+             * command-line flag.
+             *
+             * The following example demonstrates how a mock is created for a module.
+             *
+             * ```js
+             * test('mocks a builtin module in both module systems', async (t) => {
+             *   // Create a mock of 'node:readline' with a named export named 'fn', which
+             *   // does not exist in the original 'node:readline' module.
+             *   const mock = t.mock.module('node:readline', {
+             *     namedExports: { fn() { return 42; } },
+             *   });
              *
-             * Only available through the [--experimental-test-module-mocks](https://nodejs.org/api/cli.html#--experimental-test-module-mocks) flag.
-             * @since v20.18.0
+             *   let esmImpl = await import('node:readline');
+             *   let cjsImpl = require('node:readline');
+             *
+             *   // cursorTo() is an export of the original 'node:readline' module.
+             *   assert.strictEqual(esmImpl.cursorTo, undefined);
+             *   assert.strictEqual(cjsImpl.cursorTo, undefined);
+             *   assert.strictEqual(esmImpl.fn(), 42);
+             *   assert.strictEqual(cjsImpl.fn(), 42);
+             *
+             *   mock.restore();
+             *
+             *   // The mock is restored, so the original builtin module is returned.
+             *   esmImpl = await import('node:readline');
+             *   cjsImpl = require('node:readline');
+             *
+             *   assert.strictEqual(typeof esmImpl.cursorTo, 'function');
+             *   assert.strictEqual(typeof cjsImpl.cursorTo, 'function');
+             *   assert.strictEqual(esmImpl.fn, undefined);
+             *   assert.strictEqual(cjsImpl.fn, undefined);
+             * });
+             * ```
+             * @since v22.3.0
              * @experimental
              * @param specifier A string identifying the module to mock.
              * @param options Optional configuration options for the mock module.
              */
             module(specifier: string, options?: MockModuleOptions): MockModuleContext;
+            /**
+             * Creates a mock for a property value on an object. This allows you to track and control access to a specific property,
+             * including how many times it is read (getter) or written (setter), and to restore the original value after mocking.
+             *
+             * ```js
+             * test('mocks a property value', (t) => {
+             *   const obj = { foo: 42 };
+             *   const prop = t.mock.property(obj, 'foo', 100);
+             *
+             *   assert.strictEqual(obj.foo, 100);
+             *   assert.strictEqual(prop.mock.accessCount(), 1);
+             *   assert.strictEqual(prop.mock.accesses[0].type, 'get');
+             *   assert.strictEqual(prop.mock.accesses[0].value, 100);
+             *
+             *   obj.foo = 200;
+             *   assert.strictEqual(prop.mock.accessCount(), 2);
+             *   assert.strictEqual(prop.mock.accesses[1].type, 'set');
+             *   assert.strictEqual(prop.mock.accesses[1].value, 200);
+             *
+             *   prop.mock.restore();
+             *   assert.strictEqual(obj.foo, 42);
+             * });
+             * ```
+             * @since v24.3.0
+             * @param object The object whose value is being mocked.
+             * @param propertyName The identifier of the property on `object` to mock.
+             * @param value An optional value used as the mock value
+             * for `object[propertyName]`. **Default:** The original property value.
+             * @returns A proxy to the mocked object. The mocked object contains a
+             * special `mock` property, which is an instance of [`MockPropertyContext`][], and
+             * can be used for inspecting and changing the behavior of the mocked property.
+             */
+            property<
+                MockedObject extends object,
+                PropertyName extends keyof MockedObject,
+            >(
+                object: MockedObject,
+                property: PropertyName,
+                value?: MockedObject[PropertyName],
+            ): MockedObject & { mock: MockPropertyContext<MockedObject[PropertyName]> };
             /**
              * This function restores the default behavior of all mocks that were previously
              * created by this `MockTracker` and disassociates the mocks from the `MockTracker` instance. Once disassociated, the mocks can still be used, but the `MockTracker` instance can no longer be
@@ -1476,13 +1911,77 @@ declare module "node:test" {
             restore(): void;
         }
         /**
-         * @since v20.18.0
+         * @since v22.3.0
          * @experimental
          */
         interface MockModuleContext {
             /**
              * Resets the implementation of the mock module.
-             * @since v20.18.0
+             * @since v22.3.0
+             */
+            restore(): void;
+        }
+        /**
+         * @since v24.3.0
+         */
+        class MockPropertyContext<PropertyType = any> {
+            /**
+             * A getter that returns a copy of the internal array used to track accesses (get/set) to
+             * the mocked property. Each entry in the array is an object with the following properties:
+             */
+            readonly accesses: Array<{
+                type: "get" | "set";
+                value: PropertyType;
+                stack: Error;
+            }>;
+            /**
+             * This function returns the number of times that the property was accessed.
+             * This function is more efficient than checking `ctx.accesses.length` because
+             * `ctx.accesses` is a getter that creates a copy of the internal access tracking array.
+             * @returns The number of times that the property was accessed (read or written).
+             */
+            accessCount(): number;
+            /**
+             * This function is used to change the value returned by the mocked property getter.
+             * @param value The new value to be set as the mocked property value.
+             */
+            mockImplementation(value: PropertyType): void;
+            /**
+             * This function is used to change the behavior of an existing mock for a single
+             * invocation. Once invocation `onAccess` has occurred, the mock will revert to
+             * whatever behavior it would have used had `mockImplementationOnce()` not been
+             * called.
+             *
+             * The following example creates a mock function using `t.mock.property()`, calls the
+             * mock property, changes the mock implementation to a different value for the
+             * next invocation, and then resumes its previous behavior.
+             *
+             * ```js
+             * test('changes a mock behavior once', (t) => {
+             *   const obj = { foo: 1 };
+             *
+             *   const prop = t.mock.property(obj, 'foo', 5);
+             *
+             *   assert.strictEqual(obj.foo, 5);
+             *   prop.mock.mockImplementationOnce(25);
+             *   assert.strictEqual(obj.foo, 25);
+             *   assert.strictEqual(obj.foo, 5);
+             * });
+             * ```
+             * @param value The value to be used as the mock's
+             * implementation for the invocation number specified by `onAccess`.
+             * @param onAccess The invocation number that will use `value`. If
+             * the specified invocation has already occurred then an exception is thrown.
+             * **Default:** The number of the next invocation.
+             */
+            mockImplementationOnce(value: PropertyType, onAccess?: number): void;
+            /**
+             * Resets the access history of the mocked property.
+             */
+            resetAccesses(): void;
+            /**
+             * Resets the implementation of the mock property to its original behavior. The
+             * mock can still be used after calling this function.
              */
             restore(): void;
         }
@@ -1501,7 +2000,6 @@ declare module "node:test" {
          * The `MockTracker` provides a top-level `timers` export
          * which is a `MockTimers` instance.
          * @since v20.4.0
-         * @experimental
          */
         interface MockTimers {
             /**
@@ -1706,6 +2204,52 @@ declare module "node:test" {
              */
             [Symbol.dispose](): void;
         }
+        /**
+         * An object whose methods are used to configure available assertions on the
+         * `TestContext` objects in the current process. The methods from `node:assert`
+         * and snapshot testing functions are available by default.
+         *
+         * It is possible to apply the same configuration to all files by placing common
+         * configuration code in a module
+         * preloaded with `--require` or `--import`.
+         * @since v22.14.0
+         */
+        namespace assert {
+            /**
+             * Defines a new assertion function with the provided name and function. If an
+             * assertion already exists with the same name, it is overwritten.
+             * @since v22.14.0
+             */
+            function register(name: string, fn: (this: TestContext, ...args: any[]) => void): void;
+        }
+        /**
+         * @since v22.3.0
+         */
+        namespace snapshot {
+            /**
+             * This function is used to customize the default serialization mechanism used by the test runner.
+             *
+             * By default, the test runner performs serialization by calling `JSON.stringify(value, null, 2)` on the provided value.
+             * `JSON.stringify()` does have limitations regarding circular structures and supported data types.
+             * If a more robust serialization mechanism is required, this function should be used to specify a list of custom serializers.
+             *
+             * Serializers are called in order, with the output of the previous serializer passed as input to the next.
+             * The final result must be a string value.
+             * @since v22.3.0
+             * @param serializers An array of synchronous functions used as the default serializers for snapshot tests.
+             */
+            function setDefaultSnapshotSerializers(serializers: ReadonlyArray<(value: any) => any>): void;
+            /**
+             * This function is used to set a custom resolver for the location of the snapshot file used for snapshot testing.
+             * By default, the snapshot filename is the same as the entry point filename with `.snapshot` appended.
+             * @since v22.3.0
+             * @param fn A function used to compute the location of the snapshot file.
+             * The function receives the path of the test file as its only argument. If the
+             * test is not associated with a file (for example in the REPL), the input is
+             * undefined. `fn()` must return a string specifying the location of the snapshot file.
+             */
+            function setResolveSnapshotPath(fn: (path: string | undefined) => string): void;
+        }
     }
     type FunctionPropertyNames<T> = {
         [K in keyof T]: T[K] extends Function ? K : never;
@@ -1725,10 +2269,10 @@ declare module "node:test" {
  * work:
  *
  * ```js
- * import test from 'test/reporters';
+ * import test from 'node:test/reporters';
  * ```
  * @since v19.9.0
- * @see [source](https://github.com/nodejs/node/blob/v20.13.1/lib/test/reporters.js)
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/test/reporters.js)
  */
 declare module "node:test/reporters" {
     import { Transform, TransformOptions } from "node:stream";
@@ -1746,9 +2290,16 @@ declare module "node:test/reporters" {
         | { type: "test:start"; data: EventData.TestStart }
         | { type: "test:stderr"; data: EventData.TestStderr }
         | { type: "test:stdout"; data: EventData.TestStdout }
-        | { type: "test:watch:drained"; data: undefined };
+        | { type: "test:summary"; data: EventData.TestSummary }
+        | { type: "test:watch:drained"; data: undefined }
+        | { type: "test:watch:restarted"; data: undefined };
     type TestEventGenerator = AsyncGenerator<TestEvent, void>;
 
+    interface ReporterConstructorWrapper<T extends new(...args: any[]) => Transform> {
+        new(...args: ConstructorParameters<T>): InstanceType<T>;
+        (...args: ConstructorParameters<T>): InstanceType<T>;
+    }
+
     /**
      * The `dot` reporter outputs the test results in a compact format,
      * where each passing test is represented by a `.`,
@@ -1761,13 +2312,14 @@ declare module "node:test/reporters" {
      * @since v20.0.0
      */
     function tap(source: TestEventGenerator): AsyncGenerator<string, void>;
+    class SpecReporter extends Transform {
+        constructor();
+    }
     /**
      * The `spec` reporter outputs the test results in a human-readable format.
      * @since v20.0.0
      */
-    class SpecReporter extends Transform {
-        constructor();
-    }
+    const spec: ReporterConstructorWrapper<typeof SpecReporter>;
     /**
      * The `junit` reporter outputs test results in a jUnit XML format.
      * @since v21.0.0
@@ -1778,10 +2330,10 @@ declare module "node:test/reporters" {
     }
     /**
      * The `lcov` reporter outputs test coverage when used with the
-     * [`--experimental-test-coverage`](https://nodejs.org/docs/latest-v20.x/api/cli.html#--experimental-test-coverage) flag.
+     * [`--experimental-test-coverage`](https://nodejs.org/docs/latest-v24.x/api/cli.html#--experimental-test-coverage) flag.
      * @since v22.0.0
      */
-    const lcov: LcovReporter;
+    const lcov: ReporterConstructorWrapper<typeof LcovReporter>;
 
-    export { dot, junit, lcov, SpecReporter as spec, tap, TestEvent };
+    export { dot, junit, lcov, spec, tap, TestEvent };
 }