@types/node 20.6.5 → 20.7.0

node/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Node.js (https://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Sun, 24 Sep 2023 17:34:55 GMT
+ * Last updated: Mon, 25 Sep 2023 20:06:16 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`, `structuredClone`
 

node/console.d.ts

@@ -123,7 +123,7 @@ declare module "node:console" {
              * >
              * ```
              * @since v8.3.0
-             * @param label The display label for the counter.
+             * @param [label='default'] The display label for the counter.
              */
             count(label?: string): void;
             /**
@@ -141,7 +141,7 @@ declare module "node:console" {
              * >
              * ```
              * @since v8.3.0
-             * @param label The display label for the counter.
+             * @param [label='default'] The display label for the counter.
              */
             countReset(label?: string): void;
             /**
@@ -221,7 +221,7 @@ declare module "node:console" {
             log(message?: any, ...optionalParams: any[]): void;
             /**
              * Try to construct a table with the columns of the properties of `tabularData`(or use `properties`) and rows of `tabularData` and log it. Falls back to just
-             * logging the argument if it can’t be parsed as tabular.
+             * logging the argument if it can't be parsed as tabular.
              *
              * ```js
              * // These can't be parsed as tabular data
@@ -257,6 +257,7 @@ declare module "node:console" {
              * suitable time units to `stdout`. For example, if the elapsed
              * time is 3869ms, `console.timeEnd()` displays "3.869s".
              * @since v0.1.104
+             * @param [label='default']
              */
             time(label?: string): void;
             /**
@@ -264,12 +265,13 @@ declare module "node:console" {
              * prints the result to `stdout`:
              *
              * ```js
-             * console.time('100-elements');
-             * for (let i = 0; i < 100; i++) {}
-             * console.timeEnd('100-elements');
-             * // prints 100-elements: 225.438ms
+             * console.time('bunch-of-stuff');
+             * // Do a bunch of stuff.
+             * console.timeEnd('bunch-of-stuff');
+             * // Prints: bunch-of-stuff: 225.438ms
              * ```
              * @since v0.1.104
+             * @param [label='default']
              */
             timeEnd(label?: string): void;
             /**
@@ -285,6 +287,7 @@ declare module "node:console" {
              * console.timeEnd('process');
              * ```
              * @since v10.7.0
+             * @param [label='default']
              */
             timeLog(label?: string, ...data: any[]): void;
             /**

node/events.d.ts

@@ -378,7 +378,7 @@ declare module "events" {
          * ```
          * @since v20.5.0
          * @experimental
-         * @return that removes the `abort` listener.
+         * @return Disposable that removes the `abort` listener.
          */
         static addAbortListener(signal: AbortSignal, resource: (event: Event) => void): Disposable;
         /**

node/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for non-npm package Node.js 20.6
+// Type definitions for non-npm package Node.js 20.7
 // Project: https://nodejs.org/
 // Definitions by: Microsoft TypeScript <https://github.com/Microsoft>
 //                 DefinitelyTyped <https://github.com/DefinitelyTyped>

node/module.d.ts

@@ -1,5 +1,6 @@
 /**
  * @since v0.3.7
+ * @experimental
  */
 declare module "module" {
     import { URL } from "node:url";
@@ -64,6 +65,24 @@ declare module "module" {
             originalLine: number;
             originalColumn: number;
         }
+        interface SourceOrigin {
+            /**
+             * The name of the range in the source map, if one was provided
+             */
+            name?: string;
+            /**
+             * The file name of the original source, as reported in the SourceMap
+             */
+            fileName: string;
+            /**
+             * The 1-indexed lineNumber of the corresponding call site in the original source
+             */
+            lineNumber: number;
+            /**
+             * The 1-indexed columnNumber of the corresponding call site in the original source
+             */
+            columnNumber: number;
+        }
         /**
          * @since v13.7.0, v12.17.0
          */
@@ -92,6 +111,16 @@ declare module "module" {
              * @param columnOffset The zero-indexed column number offset in the generated source
              */
             findEntry(lineOffset: number, columnOffset: number): SourceMapping;
+            /**
+             * Given a 1-indexed `lineNumber` and `columnNumber` from a call site in the generated source,
+             * find the corresponding call site location in the original source.
+             *
+             * If the `lineNumber` and `columnNumber` provided are not found in any source map,
+             * then an empty object is returned.
+             * @param lineNumber The 1-indexed line number of the call site in the generated source
+             * @param columnNumber The 1-indexed column number of the call site in the generated source
+             */
+            findOrigin(lineNumber: number, columnNumber: number): SourceOrigin | {};
         }
         interface ImportAssertions extends NodeJS.Dict<string> {
             type?: string | undefined;

node/net.d.ts

@@ -234,6 +234,14 @@ declare module "net" {
          * @return The socket itself.
          */
         ref(): this;
+        /**
+         * This property is only present if the family autoselection algorithm is enabled in `socket.connect(options)`
+         * and it is an array of the addresses that have been attempted.
+         *
+         * Each address is a string in the form of `$IP:$PORT`.
+         * If the connection was successful, then the last address is the one that the socket is currently connected to.
+         */
+        readonly autoSelectFamilyAttemptedAddresses: string[];
         /**
          * This property shows the number of characters buffered for writing. The buffer
          * may contain strings whose length after encoding is not yet known. So this number
@@ -824,6 +832,10 @@ declare module "net" {
     function createConnection(options: NetConnectOpts, connectionListener?: () => void): Socket;
     function createConnection(port: number, host?: string, connectionListener?: () => void): Socket;
     function createConnection(path: string, connectionListener?: () => void): Socket;
+    function getDefaultAutoSelectFamily(): boolean;
+    function setDefaultAutoSelectFamily(value: boolean): void;
+    function getDefaultAutoSelectFamilyAttemptTimeout(): number;
+    function setDefaultAutoSelectFamilyAttemptTimeout(value: number): void;
     /**
      * Returns `6` if `input` is an IPv6 address. Returns `4` if `input` is an IPv4
      * address in [dot-decimal notation](https://en.wikipedia.org/wiki/Dot-decimal_notation) with no leading zeroes. Otherwise, returns`0`.

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "20.6.5",
+    "version": "20.7.0",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -227,6 +227,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "072be5b926605aae9ef150e9c21bebd1e3f73cbda81a3a7b3ca17545c191ac85",
+    "typesPublisherContentHash": "02e6eee96dee00f7665189477238754d8cd9a414b7a5a0985afb2e3f140c58ad",
     "typeScriptVersion": "4.5"
 }

node/process.d.ts

@@ -68,6 +68,7 @@ declare module "process" {
                 | "mipsel"
                 | "ppc"
                 | "ppc64"
+                | "riscv64"
                 | "s390"
                 | "s390x"
                 | "x64";
@@ -895,6 +896,12 @@ declare module "process" {
                  * @since v9.3.0
                  */
                 hasUncaughtExceptionCaptureCallback(): boolean;
+                /**
+                 * The `process.sourceMapsEnabled` property returns whether the [Source Map v3](https://sourcemaps.info/spec.html) support for stack traces is enabled.
+                 * @since v20.7.0
+                 * @experimental
+                 */
+                readonly sourceMapsEnabled: boolean;
                 /**
                  * The `process.version` property contains the Node.js version string.
                  *
@@ -1068,7 +1075,7 @@ declare module "process" {
                 title: string;
                 /**
                  * The operating system CPU architecture for which the Node.js binary was compiled.
-                 * Possible values are: `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`,`'ppc64'`, `'s390'`, `'s390x'`, and `'x64'`.
+                 * Possible values are: `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`,`'ppc64'`, `'riscv64'`, `'s390'`, `'s390x'`, and `'x64'`.
                  *
                  * ```js
                  * import { arch } from 'node:process';

node/string_decoder.d.ts

@@ -14,10 +14,10 @@
  * const decoder = new StringDecoder('utf8');
  *
  * const cent = Buffer.from([0xC2, 0xA2]);
- * console.log(decoder.write(cent));
+ * console.log(decoder.write(cent)); // Prints: ¢
  *
  * const euro = Buffer.from([0xE2, 0x82, 0xAC]);
- * console.log(decoder.write(euro));
+ * console.log(decoder.write(euro)); // Prints: €
  * ```
  *
  * When a `Buffer` instance is written to the `StringDecoder` instance, an
@@ -34,7 +34,7 @@
  *
  * decoder.write(Buffer.from([0xE2]));
  * decoder.write(Buffer.from([0x82]));
- * console.log(decoder.end(Buffer.from([0xAC])));
+ * console.log(decoder.end(Buffer.from([0xAC]))); // Prints: €
  * ```
  * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/string_decoder.js)
  */
@@ -46,7 +46,7 @@ declare module "string_decoder" {
          * the end of the `Buffer`, or `TypedArray`, or `DataView` are omitted from the
          * returned string and stored in an internal buffer for the next call to`stringDecoder.write()` or `stringDecoder.end()`.
          * @since v0.1.99
-         * @param buffer A `Buffer`, or `TypedArray`, or `DataView` containing the bytes to decode.
+         * @param buffer The bytes to decode.
          */
         write(buffer: Buffer): string;
         /**
@@ -57,7 +57,7 @@ declare module "string_decoder" {
          * If the `buffer` argument is provided, one final call to `stringDecoder.write()`is performed before returning the remaining input.
          * After `end()` is called, the `stringDecoder` object can be reused for new input.
          * @since v0.9.3
-         * @param buffer A `Buffer`, or `TypedArray`, or `DataView` containing the bytes to decode.
+         * @param buffer The bytes to decode.
          */
         end(buffer?: Buffer): string;
     }

node/test.d.ts

@@ -1026,11 +1026,6 @@ declare module "node:test" {
          * mock.timers.enable(['setInterval']);
          * ```
          *
-         * ```js
-         * const { mock } = require('node:test');
-         * mock.timers.enable(['setInterval']);
-         * ```
-         *
          * The above example enables mocking for the `setInterval` timer and
          * implicitly mocks the `clearInterval` function. Only the `setInterval`and `clearInterval` functions from `node:timers`,`node:timers/promises`, and`globalThis` will be mocked.
          *
@@ -1054,11 +1049,6 @@ declare module "node:test" {
          * import { mock } from 'node:test';
          * mock.timers.reset();
          * ```
-         *
-         * ```js
-         * const { mock } = require('node:test');
-         * mock.timers.reset();
-         * ```
          * @since v20.4.0
          */
         reset(): void;
@@ -1093,24 +1083,6 @@ declare module "node:test" {
          * });
          * ```
          *
-         * ```js
-         * const assert = require('node:assert');
-         * const { test } = require('node:test');
-         *
-         * test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
-         *   const fn = context.mock.fn();
-         *   context.mock.timers.enable(['setTimeout']);
-         *
-         *   setTimeout(fn, 9999);
-         *   assert.strictEqual(fn.mock.callCount(), 0);
-         *
-         *   // Advance in time
-         *   context.mock.timers.tick(9999);
-         *
-         *   assert.strictEqual(fn.mock.callCount(), 1);
-         * });
-         * ```
-         *
          * Alternativelly, the `.tick` function can be called many times
          *
          * ```js
@@ -1131,25 +1103,6 @@ declare module "node:test" {
          *   assert.strictEqual(fn.mock.callCount(), 1);
          * });
          * ```
-         *
-         * ```js
-         * const assert = require('node:assert');
-         * const { test } = require('node:test');
-         *
-         * test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
-         *   const fn = context.mock.fn();
-         *   context.mock.timers.enable(['setTimeout']);
-         *   const nineSecs = 9000;
-         *   setTimeout(fn, nineSecs);
-         *
-         *   const twoSeconds = 3000;
-         *   context.mock.timers.tick(twoSeconds);
-         *   context.mock.timers.tick(twoSeconds);
-         *   context.mock.timers.tick(twoSeconds);
-         *
-         *   assert.strictEqual(fn.mock.callCount(), 1);
-         * });
-         * ```
          * @since v20.4.0
          */
         tick(milliseconds: number): void;
@@ -1181,28 +1134,6 @@ declare module "node:test" {
          * });
          * ```
          *
-         * ```js
-         * const assert = require('node:assert');
-         * const { test } = require('node:test');
-         *
-         * test('runAll functions following the given order', (context) => {
-         *   context.mock.timers.enable(['setTimeout']);
-         *   const results = [];
-         *   setTimeout(() => results.push(1), 9999);
-         *
-         *   // Notice that if both timers have the same timeout,
-         *   // the order of execution is guaranteed
-         *   setTimeout(() => results.push(3), 8888);
-         *   setTimeout(() => results.push(2), 8888);
-         *
-         *   assert.deepStrictEqual(results, []);
-         *
-         *   context.mock.timers.runAll();
-         *
-         *   assert.deepStrictEqual(results, [3, 2, 1]);
-         * });
-         * ```
-         *
          * **Note:** The `runAll()` function is specifically designed for
          * triggering timers in the context of timer mocking.
          * It does not have any effect on real-time system
@@ -1218,7 +1149,23 @@ declare module "node:test" {
     export { after, afterEach, before, beforeEach, describe, it, mock, only, run, skip, test, test as default, todo, Mock };
 }
 
-interface DiagnosticData {
+interface TestLocationInfo {
+    /**
+     * The column number where the test is defined, or
+     * `undefined` if the test was run through the REPL.
+     */
+    column?: number;
+    /**
+     * The path of the test file, `undefined` if test is not ran through a file.
+     */
+    file?: string;
+    /**
+     * The line number where the test is defined, or
+     * `undefined` if the test was run through the REPL.
+     */
+    line?: number;
+}
+interface DiagnosticData extends TestLocationInfo {
     /**
      * The diagnostic message.
      */
@@ -1227,12 +1174,8 @@ interface DiagnosticData {
      * The nesting level of the test.
      */
     nesting: number;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestFail {
+interface TestFail extends TestLocationInfo {
     /**
      * Additional execution metadata.
      */
@@ -1271,12 +1214,8 @@ interface TestFail {
      * Present if `context.skip` is called.
      */
     skip?: string | boolean;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestPass {
+interface TestPass extends TestLocationInfo {
     /**
      * Additional execution metadata.
      */
@@ -1311,12 +1250,8 @@ interface TestPass {
      * Present if `context.skip` is called.
      */
     skip?: string | boolean;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestPlan {
+interface TestPlan extends TestLocationInfo {
     /**
      * The nesting level of the test.
      */
@@ -1325,12 +1260,8 @@ interface TestPlan {
      * The number of subtests that have ran.
      */
     count: number;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestStart {
+interface TestStart extends TestLocationInfo {
     /**
      * The test name.
      */
@@ -1339,54 +1270,34 @@ interface TestStart {
      * The nesting level of the test.
      */
     nesting: number;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestStderr {
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
+interface TestStderr extends TestLocationInfo {
     /**
      * The message written to `stderr`
      */
     message: string;
 }
-interface TestStdout {
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
+interface TestStdout extends TestLocationInfo {
     /**
      * The message written to `stdout`
      */
     message: string;
 }
-interface TestEnqueue {
+interface TestEnqueue extends TestLocationInfo {
     /**
      * The test name
      */
     name: string;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
     /**
      * The nesting level of the test.
      */
     nesting: number;
 }
-interface TestDequeue {
+interface TestDequeue extends TestLocationInfo {
     /**
      * The test name
      */
     name: string;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
     /**
      * The nesting level of the test.
      */

node/ts4.8/console.d.ts

@@ -123,7 +123,7 @@ declare module "node:console" {
              * >
              * ```
              * @since v8.3.0
-             * @param label The display label for the counter.
+             * @param [label='default'] The display label for the counter.
              */
             count(label?: string): void;
             /**
@@ -141,7 +141,7 @@ declare module "node:console" {
              * >
              * ```
              * @since v8.3.0
-             * @param label The display label for the counter.
+             * @param [label='default'] The display label for the counter.
              */
             countReset(label?: string): void;
             /**
@@ -221,7 +221,7 @@ declare module "node:console" {
             log(message?: any, ...optionalParams: any[]): void;
             /**
              * Try to construct a table with the columns of the properties of `tabularData`(or use `properties`) and rows of `tabularData` and log it. Falls back to just
-             * logging the argument if it can’t be parsed as tabular.
+             * logging the argument if it can't be parsed as tabular.
              *
              * ```js
              * // These can't be parsed as tabular data
@@ -257,6 +257,7 @@ declare module "node:console" {
              * suitable time units to `stdout`. For example, if the elapsed
              * time is 3869ms, `console.timeEnd()` displays "3.869s".
              * @since v0.1.104
+             * @param [label='default']
              */
             time(label?: string): void;
             /**
@@ -264,12 +265,13 @@ declare module "node:console" {
              * prints the result to `stdout`:
              *
              * ```js
-             * console.time('100-elements');
-             * for (let i = 0; i < 100; i++) {}
-             * console.timeEnd('100-elements');
-             * // prints 100-elements: 225.438ms
+             * console.time('bunch-of-stuff');
+             * // Do a bunch of stuff.
+             * console.timeEnd('bunch-of-stuff');
+             * // Prints: bunch-of-stuff: 225.438ms
              * ```
              * @since v0.1.104
+             * @param [label='default']
              */
             timeEnd(label?: string): void;
             /**
@@ -285,6 +287,7 @@ declare module "node:console" {
              * console.timeEnd('process');
              * ```
              * @since v10.7.0
+             * @param [label='default']
              */
             timeLog(label?: string, ...data: any[]): void;
             /**

node/ts4.8/module.d.ts

@@ -1,5 +1,6 @@
 /**
  * @since v0.3.7
+ * @experimental
  */
 declare module "module" {
     import { URL } from "node:url";

node/ts4.8/process.d.ts

@@ -68,6 +68,7 @@ declare module "process" {
                 | "mipsel"
                 | "ppc"
                 | "ppc64"
+                | "riscv64"
                 | "s390"
                 | "s390x"
                 | "x64";
@@ -895,6 +896,12 @@ declare module "process" {
                  * @since v9.3.0
                  */
                 hasUncaughtExceptionCaptureCallback(): boolean;
+                /**
+                 * The `process.sourceMapsEnabled` property returns whether the [Source Map v3](https://sourcemaps.info/spec.html) support for stack traces is enabled.
+                 * @since v20.7.0
+                 * @experimental
+                 */
+                readonly sourceMapsEnabled: boolean;
                 /**
                  * The `process.version` property contains the Node.js version string.
                  *
@@ -1068,7 +1075,7 @@ declare module "process" {
                 title: string;
                 /**
                  * The operating system CPU architecture for which the Node.js binary was compiled.
-                 * Possible values are: `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`,`'ppc64'`, `'s390'`, `'s390x'`, and `'x64'`.
+                 * Possible values are: `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`,`'ppc64'`, `'riscv64'`, `'s390'`, `'s390x'`, and `'x64'`.
                  *
                  * ```js
                  * import { arch } from 'node:process';

node/ts4.8/string_decoder.d.ts

@@ -14,10 +14,10 @@
  * const decoder = new StringDecoder('utf8');
  *
  * const cent = Buffer.from([0xC2, 0xA2]);
- * console.log(decoder.write(cent));
+ * console.log(decoder.write(cent)); // Prints: ¢
  *
  * const euro = Buffer.from([0xE2, 0x82, 0xAC]);
- * console.log(decoder.write(euro));
+ * console.log(decoder.write(euro)); // Prints: €
  * ```
  *
  * When a `Buffer` instance is written to the `StringDecoder` instance, an
@@ -34,7 +34,7 @@
  *
  * decoder.write(Buffer.from([0xE2]));
  * decoder.write(Buffer.from([0x82]));
- * console.log(decoder.end(Buffer.from([0xAC])));
+ * console.log(decoder.end(Buffer.from([0xAC]))); // Prints: €
  * ```
  * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/string_decoder.js)
  */
@@ -46,7 +46,7 @@ declare module "string_decoder" {
          * the end of the `Buffer`, or `TypedArray`, or `DataView` are omitted from the
          * returned string and stored in an internal buffer for the next call to`stringDecoder.write()` or `stringDecoder.end()`.
          * @since v0.1.99
-         * @param buffer A `Buffer`, or `TypedArray`, or `DataView` containing the bytes to decode.
+         * @param buffer The bytes to decode.
          */
         write(buffer: Buffer): string;
         /**
@@ -57,7 +57,7 @@ declare module "string_decoder" {
          * If the `buffer` argument is provided, one final call to `stringDecoder.write()`is performed before returning the remaining input.
          * After `end()` is called, the `stringDecoder` object can be reused for new input.
          * @since v0.9.3
-         * @param buffer A `Buffer`, or `TypedArray`, or `DataView` containing the bytes to decode.
+         * @param buffer The bytes to decode.
          */
         end(buffer?: Buffer): string;
     }

node/ts4.8/test.d.ts

@@ -295,7 +295,7 @@ declare module "node:test" {
         /**
          * A function that accepts the TestsStream instance and can be used to setup listeners before any tests are run.
          */
-        setup?: (root: unknown) => void | Promise<void>;
+        setup?: (root: Test) => void | Promise<void>;
         /**
          * Whether to run in watch mode or not.
          * @default false
@@ -1026,11 +1026,6 @@ declare module "node:test" {
          * mock.timers.enable(['setInterval']);
          * ```
          *
-         * ```js
-         * const { mock } = require('node:test');
-         * mock.timers.enable(['setInterval']);
-         * ```
-         *
          * The above example enables mocking for the `setInterval` timer and
          * implicitly mocks the `clearInterval` function. Only the `setInterval`and `clearInterval` functions from `node:timers`,`node:timers/promises`, and`globalThis` will be mocked.
          *
@@ -1054,11 +1049,6 @@ declare module "node:test" {
          * import { mock } from 'node:test';
          * mock.timers.reset();
          * ```
-         *
-         * ```js
-         * const { mock } = require('node:test');
-         * mock.timers.reset();
-         * ```
          * @since v20.4.0
          */
         reset(): void;
@@ -1093,24 +1083,6 @@ declare module "node:test" {
          * });
          * ```
          *
-         * ```js
-         * const assert = require('node:assert');
-         * const { test } = require('node:test');
-         *
-         * test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
-         *   const fn = context.mock.fn();
-         *   context.mock.timers.enable(['setTimeout']);
-         *
-         *   setTimeout(fn, 9999);
-         *   assert.strictEqual(fn.mock.callCount(), 0);
-         *
-         *   // Advance in time
-         *   context.mock.timers.tick(9999);
-         *
-         *   assert.strictEqual(fn.mock.callCount(), 1);
-         * });
-         * ```
-         *
          * Alternativelly, the `.tick` function can be called many times
          *
          * ```js
@@ -1131,25 +1103,6 @@ declare module "node:test" {
          *   assert.strictEqual(fn.mock.callCount(), 1);
          * });
          * ```
-         *
-         * ```js
-         * const assert = require('node:assert');
-         * const { test } = require('node:test');
-         *
-         * test('mocks setTimeout to be executed synchronously without having to actually wait for it', (context) => {
-         *   const fn = context.mock.fn();
-         *   context.mock.timers.enable(['setTimeout']);
-         *   const nineSecs = 9000;
-         *   setTimeout(fn, nineSecs);
-         *
-         *   const twoSeconds = 3000;
-         *   context.mock.timers.tick(twoSeconds);
-         *   context.mock.timers.tick(twoSeconds);
-         *   context.mock.timers.tick(twoSeconds);
-         *
-         *   assert.strictEqual(fn.mock.callCount(), 1);
-         * });
-         * ```
          * @since v20.4.0
          */
         tick(milliseconds: number): void;
@@ -1181,28 +1134,6 @@ declare module "node:test" {
          * });
          * ```
          *
-         * ```js
-         * const assert = require('node:assert');
-         * const { test } = require('node:test');
-         *
-         * test('runAll functions following the given order', (context) => {
-         *   context.mock.timers.enable(['setTimeout']);
-         *   const results = [];
-         *   setTimeout(() => results.push(1), 9999);
-         *
-         *   // Notice that if both timers have the same timeout,
-         *   // the order of execution is guaranteed
-         *   setTimeout(() => results.push(3), 8888);
-         *   setTimeout(() => results.push(2), 8888);
-         *
-         *   assert.deepStrictEqual(results, []);
-         *
-         *   context.mock.timers.runAll();
-         *
-         *   assert.deepStrictEqual(results, [3, 2, 1]);
-         * });
-         * ```
-         *
          * **Note:** The `runAll()` function is specifically designed for
          * triggering timers in the context of timer mocking.
          * It does not have any effect on real-time system
@@ -1218,7 +1149,23 @@ declare module "node:test" {
     export { after, afterEach, before, beforeEach, describe, it, mock, only, run, skip, test, test as default, todo, Mock };
 }
 
-interface DiagnosticData {
+interface TestLocationInfo {
+    /**
+     * The column number where the test is defined, or
+     * `undefined` if the test was run through the REPL.
+     */
+    column?: number;
+    /**
+     * The path of the test file, `undefined` if test is not ran through a file.
+     */
+    file?: string;
+    /**
+     * The line number where the test is defined, or
+     * `undefined` if the test was run through the REPL.
+     */
+    line?: number;
+}
+interface DiagnosticData extends TestLocationInfo {
     /**
      * The diagnostic message.
      */
@@ -1227,12 +1174,8 @@ interface DiagnosticData {
      * The nesting level of the test.
      */
     nesting: number;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestFail {
+interface TestFail extends TestLocationInfo {
     /**
      * Additional execution metadata.
      */
@@ -1271,12 +1214,8 @@ interface TestFail {
      * Present if `context.skip` is called.
      */
     skip?: string | boolean;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestPass {
+interface TestPass extends TestLocationInfo {
     /**
      * Additional execution metadata.
      */
@@ -1311,12 +1250,8 @@ interface TestPass {
      * Present if `context.skip` is called.
      */
     skip?: string | boolean;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestPlan {
+interface TestPlan extends TestLocationInfo {
     /**
      * The nesting level of the test.
      */
@@ -1325,12 +1260,8 @@ interface TestPlan {
      * The number of subtests that have ran.
      */
     count: number;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestStart {
+interface TestStart extends TestLocationInfo {
     /**
      * The test name.
      */
@@ -1339,54 +1270,34 @@ interface TestStart {
      * The nesting level of the test.
      */
     nesting: number;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
 }
-interface TestStderr {
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
+interface TestStderr extends TestLocationInfo {
     /**
      * The message written to `stderr`
      */
     message: string;
 }
-interface TestStdout {
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
+interface TestStdout extends TestLocationInfo {
     /**
      * The message written to `stdout`
      */
     message: string;
 }
-interface TestEnqueue {
+interface TestEnqueue extends TestLocationInfo {
     /**
      * The test name
      */
     name: string;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
     /**
      * The nesting level of the test.
      */
     nesting: number;
 }
-interface TestDequeue {
+interface TestDequeue extends TestLocationInfo {
     /**
      * The test name
      */
     name: string;
-    /**
-     * The path of the test file, undefined if test is not ran through a file.
-     */
-    file?: string;
     /**
      * The nesting level of the test.
      */