@types/node 18.15.5 → 18.15.10

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: Mon, 20 Mar 2023 21:32:44 GMT
+ * Last updated: Sat, 25 Mar 2023 22:33:05 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`, `structuredClone`
 

node/diagnostics_channel.d.ts

@@ -58,6 +58,45 @@ declare module 'diagnostics_channel' {
      */
     function channel(name: string | symbol): Channel;
     type ChannelListener = (message: unknown, name: string | symbol) => void;
+    /**
+     * Register a message handler to subscribe to this channel. This message handler will be run synchronously
+     * whenever a message is published to the channel. Any errors thrown in the message handler will
+     * trigger an 'uncaughtException'.
+     *
+     * ```js
+     * import diagnostics_channel from 'diagnostics_channel';
+     *
+     * diagnostics_channel.subscribe('my-channel', (message, name) => {
+     *   // Received data
+     * });
+     * ```
+     *
+     * @since v18.7.0, v16.17.0
+     * @param name The channel name
+     * @param onMessage The handler to receive channel messages
+     */
+    function subscribe(name: string | symbol, onMessage: ChannelListener): void;
+    /**
+     * Remove a message handler previously registered to this channel with diagnostics_channel.subscribe(name, onMessage).
+     *
+     * ```js
+     * import diagnostics_channel from 'diagnostics_channel';
+     *
+     * function onMessage(message, name) {
+     *  // Received data
+     * }
+     *
+     * diagnostics_channel.subscribe('my-channel', onMessage);
+     *
+     * diagnostics_channel.unsubscribe('my-channel', onMessage);
+     * ```
+     *
+     * @since v18.7.0, v16.17.0
+     * @param name The channel name
+     * @param onMessage The previous subscribed handler to remove
+     * @returns `true` if the handler was found, `false` otherwise
+     */
+    function unsubscribe(name: string | symbol, onMessage: ChannelListener): boolean;
     /**
      * The class `Channel` represents an individual named channel within the data
      * pipeline. It is use to track subscribers and to publish messages when there

node/dns.d.ts

@@ -174,7 +174,7 @@ declare module 'dns' {
         type: 'AAAA';
     }
     export interface CaaRecord {
-        critial: number;
+        critical: number;
         issue?: string | undefined;
         issuewild?: string | undefined;
         iodef?: string | undefined;

node/http.d.ts

@@ -144,6 +144,7 @@ declare module 'http' {
         socketPath?: string | undefined;
         timeout?: number | undefined;
         uniqueHeaders?: Array<string | string[]> | undefined;
+        joinDuplicateHeaders?: boolean;
     }
     interface ServerOptions<
         Request extends typeof IncomingMessage = typeof IncomingMessage,
@@ -164,6 +165,12 @@ declare module 'http' {
          * @since v18.0.0
          */
         requestTimeout?: number | undefined;
+        /**
+         * It joins the field line values of multiple headers in a request with `, ` instead of discarding the duplicates.
+         * @default false
+         * @since v18.14.0
+         */
+        joinDuplicateHeaders?: boolean;
         /**
          * The number of milliseconds of inactivity a server needs to wait for additional incoming data,
          * after it has finished writing the last response, before a socket will be destroyed.

node/http2.d.ts

@@ -1053,7 +1053,6 @@ declare module 'http2' {
          */
         unknownProtocolTimeout?: number | undefined;
         selectPadding?(frameLen: number, maxFrameLen: number): number;
-        createConnection?(authority: url.URL, option: SessionOptions): stream.Duplex;
     }
     export interface ClientSessionOptions extends SessionOptions {
         maxReservedRemoteStreams?: number | undefined;

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "18.15.5",
+    "version": "18.15.10",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -232,6 +232,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "dbeb99b03a082a478a5124e1b36307ac5c680e2c151da45fdbb731f85ff49909",
+    "typesPublisherContentHash": "d968764271bc711c7d024195dad3ccfa3e82756092d060a8df0f5a57a517c842",
     "typeScriptVersion": "4.3"
 }

node/process.d.ts

@@ -1089,6 +1089,12 @@ declare module 'process' {
                  */
                 mainModule?: Module | undefined;
                 memoryUsage: MemoryUsageFn;
+                /**
+                 * Gets the amount of memory available to the process (in bytes) based on
+                 * limits imposed by the OS. If there is no such constraint, or the constraint
+                 * is unknown, `undefined` is returned.
+                 */
+                constrainedMemory(): number | undefined;
                 /**
                  * The `process.cpuUsage()` method returns the user and system CPU time usage of
                  * the current process, in an object with properties `user` and `system`, whose

node/test.d.ts

@@ -7,16 +7,16 @@ declare module 'node:test' {
      * Programmatically start the test runner.
      * @since v18.9.0
      * @param options Configuration options for running tests.
-     * @returns A {@link TapStream} that emits events about the test execution.
+     * @returns A {@link TestsStream} that emits events about the test execution.
      */
-    function run(options?: RunOptions): TapStream;
+    function run(options?: RunOptions): TestsStream;
 
     /**
      * The `test()` function is the value imported from the test module. Each invocation of this
-     * function results in the creation of a test point in the TAP output.
+     * function results in reporting the test to the {@link TestsStream}.
      *
      * The {@link TestContext} object passed to the fn argument can be used to perform actions
-     * related to the current test. Examples include skipping the test, adding additional TAP
+     * related to the current test. Examples include skipping the test, adding additional
      * diagnostic information, or creating subtests.
      *
      * `test()` returns a {@link Promise} that resolves once the test completes. The return value
@@ -158,54 +158,88 @@ declare module 'node:test' {
     }
 
     /**
-     * A successful call of the `run()` method will return a new `TapStream` object,
-     * streaming a [TAP](https://testanything.org/) output.
-     * `TapStream` will emit events in the order of the tests' definitions.
+     * A successful call of the `run()` method will return a new `TestsStream` object,
+     * streaming a series of events representing the execution of the tests.
+     * `TestsStream` will emit events in the order of the tests' definitions.
      * @since v18.9.0
      */
-    interface TapStream extends NodeJS.ReadableStream {
-        addListener(event: 'test:diagnostic', listener: (message: string) => void): this;
+    interface TestsStream extends NodeJS.ReadableStream {
+        addListener(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         addListener(event: 'test:fail', listener: (data: TestFail) => void): this;
         addListener(event: 'test:pass', listener: (data: TestPass) => void): this;
+        addListener(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        addListener(event: 'test:start', listener: (data: TestStart) => void): this;
         addListener(event: string, listener: (...args: any[]) => void): this;
-        emit(event: 'test:diagnostic', message: string): boolean;
+        emit(event: 'test:diagnostic', data: DiagnosticData): boolean;
         emit(event: 'test:fail', data: TestFail): boolean;
         emit(event: 'test:pass', data: TestPass): boolean;
+        emit(event: 'test:plan', data: TestPlan): boolean;
+        emit(event: 'test:start', data: TestStart): boolean;
         emit(event: string | symbol, ...args: any[]): boolean;
-        on(event: 'test:diagnostic', listener: (message: string) => void): this;
+        on(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         on(event: 'test:fail', listener: (data: TestFail) => void): this;
         on(event: 'test:pass', listener: (data: TestPass) => void): this;
+        on(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        on(event: 'test:start', listener: (data: TestStart) => void): this;
         on(event: string, listener: (...args: any[]) => void): this;
-        once(event: 'test:diagnostic', listener: (message: string) => void): this;
+        once(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         once(event: 'test:fail', listener: (data: TestFail) => void): this;
         once(event: 'test:pass', listener: (data: TestPass) => void): this;
+        once(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        once(event: 'test:start', listener: (data: TestStart) => void): this;
         once(event: string, listener: (...args: any[]) => void): this;
-        prependListener(event: 'test:diagnostic', listener: (message: string) => void): this;
+        prependListener(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         prependListener(event: 'test:fail', listener: (data: TestFail) => void): this;
         prependListener(event: 'test:pass', listener: (data: TestPass) => void): this;
+        prependListener(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        prependListener(event: 'test:start', listener: (data: TestStart) => void): this;
         prependListener(event: string, listener: (...args: any[]) => void): this;
-        prependOnceListener(event: 'test:diagnostic', listener: (message: string) => void): this;
+        prependOnceListener(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         prependOnceListener(event: 'test:fail', listener: (data: TestFail) => void): this;
         prependOnceListener(event: 'test:pass', listener: (data: TestPass) => void): this;
+        prependOnceListener(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        prependOnceListener(event: 'test:start', listener: (data: TestStart) => void): this;
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
     }
 
-    interface TestFail {
+    interface DiagnosticData {
+        /**
+         * The diagnostic message.
+         */
+        message: string;
+
         /**
-         * The test duration.
+         * The nesting level of the test.
          */
-        duration: number;
+        nesting: number;
+    }
 
+    interface TestFail {
         /**
-         * The failure casing test to fail.
+         * Additional execution metadata.
          */
-        error: Error;
+        details: {
+            /**
+             * The duration of the test in milliseconds.
+             */
+            duration: number;
+
+            /**
+             * The error thrown by the test.
+             */
+            error: Error;
+        };
 
         /**
          * The test name.
          */
         name: string;
 
+        /**
+         * The nesting level of the test.
+         */
+        nesting: number;
+
         /**
          * The ordinal number of the test.
          */
@@ -214,25 +248,35 @@ declare module 'node:test' {
         /**
          * Present if `context.todo` is called.
          */
-        todo?: string;
+        todo?: string | boolean;
 
         /**
          * Present if `context.skip` is called.
          */
-        skip?: string;
+        skip?: string | boolean;
     }
 
     interface TestPass {
         /**
-         * The test duration.
+         * Additional execution metadata.
          */
-        duration: number;
+        details: {
+            /**
+             * The duration of the test in milliseconds.
+             */
+            duration: number;
+        };
 
         /**
          * The test name.
          */
         name: string;
 
+        /**
+         * The nesting level of the test.
+         */
+        nesting: number;
+
         /**
          * The ordinal number of the test.
          */
@@ -241,12 +285,36 @@ declare module 'node:test' {
         /**
          * Present if `context.todo` is called.
          */
-        todo?: string;
+        todo?: string | boolean;
 
         /**
          * Present if `context.skip` is called.
          */
-        skip?: string;
+        skip?: string | boolean;
+    }
+
+    interface TestPlan {
+        /**
+         * The nesting level of the test.
+         */
+        nesting: number;
+
+        /**
+         * The number of subtests that have ran.
+         */
+        count: number;
+    }
+
+    interface TestStart {
+        /**
+         * The test name.
+         */
+        name: string;
+
+        /**
+         * The nesting level of the test.
+         */
+        nesting: number;
     }
 
     /**
@@ -283,9 +351,9 @@ declare module 'node:test' {
         afterEach: typeof afterEach;
 
         /**
-         * This function is used to write TAP diagnostics to the output. Any diagnostic information is
+         * This function is used to write diagnostics to the output. Any diagnostic information is
          * included at the end of the test's results. This function does not return a value.
-         * @param message Message to be displayed as a TAP diagnostic.
+         * @param message Message to be reported.
          * @since v18.0.0
          */
         diagnostic(message: string): void;
@@ -313,18 +381,18 @@ declare module 'node:test' {
 
         /**
          * This function causes the test's output to indicate the test as skipped. If `message` is
-         * provided, it is included in the TAP output. Calling `skip()` does not terminate execution of
+         * provided, it is included in the output. Calling `skip()` does not terminate execution of
          * the test function. This function does not return a value.
-         * @param message Optional skip message to be displayed in TAP output.
+         * @param message Optional skip message.
          * @since v18.0.0
          */
         skip(message?: string): void;
 
         /**
          * This function adds a `TODO` directive to the test's output. If `message` is provided, it is
-         * included in the TAP output. Calling `todo()` does not terminate execution of the test
+         * included in the output. Calling `todo()` does not terminate execution of the test
          * function. This function does not return a value.
-         * @param message Optional `TODO` message to be displayed in TAP output.
+         * @param message Optional `TODO` message.
          * @since v18.0.0
          */
         todo(message?: string): void;

node/ts4.8/diagnostics_channel.d.ts

@@ -20,7 +20,7 @@
  * should generally include the module name to avoid collisions with data from
  * other modules.
  * @experimental
- * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/diagnostics_channel.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.7.0/lib/diagnostics_channel.js)
  */
 declare module 'diagnostics_channel' {
     /**
@@ -58,6 +58,45 @@ declare module 'diagnostics_channel' {
      */
     function channel(name: string | symbol): Channel;
     type ChannelListener = (message: unknown, name: string | symbol) => void;
+    /**
+     * Register a message handler to subscribe to this channel. This message handler will be run synchronously
+     * whenever a message is published to the channel. Any errors thrown in the message handler will
+     * trigger an 'uncaughtException'.
+     *
+     * ```js
+     * import diagnostics_channel from 'diagnostics_channel';
+     *
+     * diagnostics_channel.subscribe('my-channel', (message, name) => {
+     *   // Received data
+     * });
+     * ```
+     *
+     * @since v18.7.0, v16.17.0
+     * @param name The channel name
+     * @param onMessage The handler to receive channel messages
+     */
+    function subscribe(name: string | symbol, onMessage: ChannelListener): void;
+    /**
+     * Remove a message handler previously registered to this channel with diagnostics_channel.subscribe(name, onMessage).
+     *
+     * ```js
+     * import diagnostics_channel from 'diagnostics_channel';
+     *
+     * function onMessage(message, name) {
+     *  // Received data
+     * }
+     *
+     * diagnostics_channel.subscribe('my-channel', onMessage);
+     *
+     * diagnostics_channel.unsubscribe('my-channel', onMessage);
+     * ```
+     *
+     * @since v18.7.0, v16.17.0
+     * @param name The channel name
+     * @param onMessage The previous subscribed handler to remove
+     * @returns `true` if the handler was found, `false` otherwise
+     */
+    function unsubscribe(name: string | symbol, onMessage: ChannelListener): boolean;
     /**
      * The class `Channel` represents an individual named channel within the data
      * pipeline. It is use to track subscribers and to publish messages when there

node/ts4.8/dns.d.ts

@@ -174,7 +174,7 @@ declare module 'dns' {
         type: 'AAAA';
     }
     export interface CaaRecord {
-        critial: number;
+        critical: number;
         issue?: string | undefined;
         issuewild?: string | undefined;
         iodef?: string | undefined;

node/ts4.8/http2.d.ts

@@ -1053,7 +1053,6 @@ declare module 'http2' {
          */
         unknownProtocolTimeout?: number | undefined;
         selectPadding?(frameLen: number, maxFrameLen: number): number;
-        createConnection?(authority: url.URL, option: SessionOptions): stream.Duplex;
     }
     export interface ClientSessionOptions extends SessionOptions {
         maxReservedRemoteStreams?: number | undefined;

node/ts4.8/process.d.ts

@@ -1089,6 +1089,12 @@ declare module 'process' {
                  */
                 mainModule?: Module | undefined;
                 memoryUsage: MemoryUsageFn;
+                /**
+                 * Gets the amount of memory available to the process (in bytes) based on
+                 * limits imposed by the OS. If there is no such constraint, or the constraint
+                 * is unknown, `undefined` is returned.
+                 */
+                constrainedMemory(): number | undefined;
                 /**
                  * The `process.cpuUsage()` method returns the user and system CPU time usage of
                  * the current process, in an object with properties `user` and `system`, whose

node/ts4.8/test.d.ts

@@ -7,16 +7,16 @@ declare module 'node:test' {
      * Programmatically start the test runner.
      * @since v18.9.0
      * @param options Configuration options for running tests.
-     * @returns A {@link TapStream} that emits events about the test execution.
+     * @returns A {@link TestsStream} that emits events about the test execution.
      */
-    function run(options?: RunOptions): TapStream;
+    function run(options?: RunOptions): TestsStream;
 
     /**
      * The `test()` function is the value imported from the test module. Each invocation of this
-     * function results in the creation of a test point in the TAP output.
+     * function results in reporting the test to the {@link TestsStream}.
      *
      * The {@link TestContext} object passed to the fn argument can be used to perform actions
-     * related to the current test. Examples include skipping the test, adding additional TAP
+     * related to the current test. Examples include skipping the test, adding additional
      * diagnostic information, or creating subtests.
      *
      * `test()` returns a {@link Promise} that resolves once the test completes. The return value
@@ -158,54 +158,88 @@ declare module 'node:test' {
     }
 
     /**
-     * A successful call of the `run()` method will return a new `TapStream` object,
-     * streaming a [TAP](https://testanything.org/) output.
-     * `TapStream` will emit events in the order of the tests' definitions.
+     * A successful call of the `run()` method will return a new `TestsStream` object,
+     * streaming a series of events representing the execution of the tests.
+     * `TestsStream` will emit events in the order of the tests' definitions.
      * @since v18.9.0
      */
-    interface TapStream extends NodeJS.ReadableStream {
-        addListener(event: 'test:diagnostic', listener: (message: string) => void): this;
+    interface TestsStream extends NodeJS.ReadableStream {
+        addListener(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         addListener(event: 'test:fail', listener: (data: TestFail) => void): this;
         addListener(event: 'test:pass', listener: (data: TestPass) => void): this;
+        addListener(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        addListener(event: 'test:start', listener: (data: TestStart) => void): this;
         addListener(event: string, listener: (...args: any[]) => void): this;
-        emit(event: 'test:diagnostic', message: string): boolean;
+        emit(event: 'test:diagnostic', data: DiagnosticData): boolean;
         emit(event: 'test:fail', data: TestFail): boolean;
         emit(event: 'test:pass', data: TestPass): boolean;
+        emit(event: 'test:plan', data: TestPlan): boolean;
+        emit(event: 'test:start', data: TestStart): boolean;
         emit(event: string | symbol, ...args: any[]): boolean;
-        on(event: 'test:diagnostic', listener: (message: string) => void): this;
+        on(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         on(event: 'test:fail', listener: (data: TestFail) => void): this;
         on(event: 'test:pass', listener: (data: TestPass) => void): this;
+        on(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        on(event: 'test:start', listener: (data: TestStart) => void): this;
         on(event: string, listener: (...args: any[]) => void): this;
-        once(event: 'test:diagnostic', listener: (message: string) => void): this;
+        once(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         once(event: 'test:fail', listener: (data: TestFail) => void): this;
         once(event: 'test:pass', listener: (data: TestPass) => void): this;
+        once(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        once(event: 'test:start', listener: (data: TestStart) => void): this;
         once(event: string, listener: (...args: any[]) => void): this;
-        prependListener(event: 'test:diagnostic', listener: (message: string) => void): this;
+        prependListener(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         prependListener(event: 'test:fail', listener: (data: TestFail) => void): this;
         prependListener(event: 'test:pass', listener: (data: TestPass) => void): this;
+        prependListener(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        prependListener(event: 'test:start', listener: (data: TestStart) => void): this;
         prependListener(event: string, listener: (...args: any[]) => void): this;
-        prependOnceListener(event: 'test:diagnostic', listener: (message: string) => void): this;
+        prependOnceListener(event: 'test:diagnostic', listener: (data: DiagnosticData) => void): this;
         prependOnceListener(event: 'test:fail', listener: (data: TestFail) => void): this;
         prependOnceListener(event: 'test:pass', listener: (data: TestPass) => void): this;
+        prependOnceListener(event: 'test:plan', listener: (data: TestPlan) => void): this;
+        prependOnceListener(event: 'test:start', listener: (data: TestStart) => void): this;
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
     }
 
-    interface TestFail {
+    interface DiagnosticData {
+        /**
+         * The diagnostic message.
+         */
+        message: string;
+
         /**
-         * The test duration.
+         * The nesting level of the test.
          */
-        duration: number;
+        nesting: number;
+    }
 
+    interface TestFail {
         /**
-         * The failure casing test to fail.
+         * Additional execution metadata.
          */
-        error: Error;
+        details: {
+            /**
+             * The duration of the test in milliseconds.
+             */
+            duration: number;
+
+            /**
+             * The error thrown by the test.
+             */
+            error: Error;
+        };
 
         /**
          * The test name.
          */
         name: string;
 
+        /**
+         * The nesting level of the test.
+         */
+        nesting: number;
+
         /**
          * The ordinal number of the test.
          */
@@ -214,25 +248,35 @@ declare module 'node:test' {
         /**
          * Present if `context.todo` is called.
          */
-        todo?: string;
+        todo?: string | boolean;
 
         /**
          * Present if `context.skip` is called.
          */
-        skip?: string;
+        skip?: string | boolean;
     }
 
     interface TestPass {
         /**
-         * The test duration.
+         * Additional execution metadata.
          */
-        duration: number;
+        details: {
+            /**
+             * The duration of the test in milliseconds.
+             */
+            duration: number;
+        };
 
         /**
          * The test name.
          */
         name: string;
 
+        /**
+         * The nesting level of the test.
+         */
+        nesting: number;
+
         /**
          * The ordinal number of the test.
          */
@@ -241,12 +285,36 @@ declare module 'node:test' {
         /**
          * Present if `context.todo` is called.
          */
-        todo?: string;
+        todo?: string | boolean;
 
         /**
          * Present if `context.skip` is called.
          */
-        skip?: string;
+        skip?: string | boolean;
+    }
+
+    interface TestPlan {
+        /**
+         * The nesting level of the test.
+         */
+        nesting: number;
+
+        /**
+         * The number of subtests that have ran.
+         */
+        count: number;
+    }
+
+    interface TestStart {
+        /**
+         * The test name.
+         */
+        name: string;
+
+        /**
+         * The nesting level of the test.
+         */
+        nesting: number;
     }
 
     /**
@@ -283,9 +351,9 @@ declare module 'node:test' {
         afterEach: typeof afterEach;
 
         /**
-         * This function is used to write TAP diagnostics to the output. Any diagnostic information is
+         * This function is used to write diagnostics to the output. Any diagnostic information is
          * included at the end of the test's results. This function does not return a value.
-         * @param message Message to be displayed as a TAP diagnostic.
+         * @param message Message to be reported.
          * @since v18.0.0
          */
         diagnostic(message: string): void;
@@ -313,18 +381,18 @@ declare module 'node:test' {
 
         /**
          * This function causes the test's output to indicate the test as skipped. If `message` is
-         * provided, it is included in the TAP output. Calling `skip()` does not terminate execution of
+         * provided, it is included in the output. Calling `skip()` does not terminate execution of
          * the test function. This function does not return a value.
-         * @param message Optional skip message to be displayed in TAP output.
+         * @param message Optional skip message.
          * @since v18.0.0
          */
         skip(message?: string): void;
 
         /**
          * This function adds a `TODO` directive to the test's output. If `message` is provided, it is
-         * included in the TAP output. Calling `todo()` does not terminate execution of the test
+         * included in the output. Calling `todo()` does not terminate execution of the test
          * function. This function does not return a value.
-         * @param message Optional `TODO` message to be displayed in TAP output.
+         * @param message Optional `TODO` message.
          * @since v18.0.0
          */
         todo(message?: string): void;

node/ts4.8/v8.d.ts

@@ -390,6 +390,57 @@ declare module 'v8' {
      * @since v15.1.0, v14.18.0, v12.22.0
      */
     function stopCoverage(): void;
+
+    /**
+     * This API collects GC data in current thread.
+     */
+    class GCProfiler {
+        /**
+         * Start collecting GC data.
+         */
+        start(): void;
+        /**
+         * Stop collecting GC data and return a object.
+         */
+        stop(): GCProfilerResult;
+    }
+    interface GCProfilerResult {
+        version: number;
+        startTime: number;
+        endTime: number;
+        statistics: Array<{
+            gcType: string;
+            cost: number;
+            beforeGC: {
+                heapStatistics: HeapStatistics;
+                heapSpaceStatistics: HeapSpaceStatistics[];
+            };
+            afterGC: {
+                heapStatistics: HeapStatistics;
+                heapSpaceStatistics: HeapSpaceStatistics[];
+            };
+        }>;
+    }
+    interface HeapStatistics {
+        totalHeapSize: number;
+        totalHeapSizeExecutable: number;
+        totalPhysicalSize: number;
+        totalAvailableSize: number;
+        totalGlobalHandlesSize: number;
+        usedGlobalHandlesSize: number;
+        usedHeapSize: number;
+        heapSizeLimit: number;
+        mallocedMemory: number;
+        externalMemory: number;
+        peakMallocedMemory: number;
+    }
+    interface HeapSpaceStatistics {
+        spaceName: string;
+        spaceSize: number;
+        spaceUsedSize: number;
+        spaceAvailableSize: number;
+        physicalSpaceSize: number;
+    }
 }
 declare module 'node:v8' {
     export * from 'v8';

node/ts4.8/vm.d.ts

@@ -56,11 +56,17 @@ declare module 'vm' {
         columnOffset?: number | undefined;
     }
     interface ScriptOptions extends BaseOptions {
-        displayErrors?: boolean | undefined;
-        timeout?: number | undefined;
-        cachedData?: Buffer | undefined;
+        /**
+         * V8's code cache data for the supplied source.
+         */
+        cachedData?: Buffer | NodeJS.ArrayBufferView | undefined;
         /** @deprecated in favor of `script.createCachedData()` */
         produceCachedData?: boolean | undefined;
+        /**
+         * Called during evaluation of this module when `import()` is called.
+         * If this option is not specified, calls to `import()` will reject with `ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`.
+         */
+        importModuleDynamically?: ((specifier: string, script: Script, importAssertions: Object) => Module) | undefined;
     }
     interface RunningScriptOptions extends BaseOptions {
         /**
@@ -80,10 +86,31 @@ declare module 'vm' {
          * Default: `false`.
          */
         breakOnSigint?: boolean | undefined;
+    }
+    interface RunningScriptInNewContextOptions extends RunningScriptOptions {
+        /**
+         * Human-readable name of the newly created context.
+         */
+        contextName?: CreateContextOptions['name'];
+        /**
+         * Origin corresponding to the newly created context for display purposes. The origin should be formatted like a URL,
+         * but with only the scheme, host, and port (if necessary), like the value of the `url.origin` property of a `URL` object.
+         * Most notably, this string should omit the trailing slash, as that denotes a path.
+         */
+        contextOrigin?: CreateContextOptions['origin'];
+        contextCodeGeneration?: CreateContextOptions['codeGeneration'];
         /**
          * If set to `afterEvaluate`, microtasks will be run immediately after the script has run.
          */
-        microtaskMode?: 'afterEvaluate' | undefined;
+        microtaskMode?: CreateContextOptions['microtaskMode'];
+    }
+    interface RunningCodeOptions extends RunningScriptOptions {
+        cachedData?: ScriptOptions['cachedData'];
+        importModuleDynamically?: ScriptOptions['importModuleDynamically'];
+    }
+    interface RunningCodeInNewContextOptions extends RunningScriptInNewContextOptions {
+        cachedData?: ScriptOptions['cachedData'];
+        importModuleDynamically?: ScriptOptions['importModuleDynamically'];
     }
     interface CompileFunctionOptions extends BaseOptions {
         /**
@@ -144,7 +171,10 @@ declare module 'vm' {
          * @default 'summary'
          */
         mode?: MeasureMemoryMode | undefined;
-        context?: Context | undefined;
+        /**
+         * @default 'default'
+         */
+        execution?: 'default' | 'eager' | undefined;
     }
     interface MemoryMeasurement {
         total: {
@@ -158,7 +188,7 @@ declare module 'vm' {
      * @since v0.3.1
      */
     class Script {
-        constructor(code: string, options?: ScriptOptions);
+        constructor(code: string, options?: ScriptOptions | string);
         /**
          * Runs the compiled code contained by the `vm.Script` object within the given`contextifiedObject` and returns the result. Running code does not have access
          * to local scope.
@@ -220,7 +250,7 @@ declare module 'vm' {
          * @param contextObject An object that will be `contextified`. If `undefined`, a new object will be created.
          * @return the result of the very last statement executed in the script.
          */
-        runInNewContext(contextObject?: Context, options?: RunningScriptOptions): any;
+        runInNewContext(contextObject?: Context, options?: RunningScriptInNewContextOptions): any;
         /**
          * Runs the compiled code contained by the `vm.Script` within the context of the
          * current `global` object. Running code does not have access to local scope, but _does_ have access to the current `global` object.
@@ -273,6 +303,10 @@ declare module 'vm' {
         cachedDataProduced?: boolean | undefined;
         cachedDataRejected?: boolean | undefined;
         cachedData?: Buffer | undefined;
+        /**
+         * When the script is compiled from a source that contains a source map magic comment, this property will be set to the URL of the source map.
+         */
+        sourceMapURL?: string | undefined;
     }
     /**
      * If given a `contextObject`, the `vm.createContext()` method will `prepare
@@ -345,7 +379,7 @@ declare module 'vm' {
      * @param contextifiedObject The `contextified` object that will be used as the `global` when the `code` is compiled and run.
      * @return the result of the very last statement executed in the script.
      */
-    function runInContext(code: string, contextifiedObject: Context, options?: RunningScriptOptions | string): any;
+    function runInContext(code: string, contextifiedObject: Context, options?: RunningCodeOptions | string): any;
     /**
      * The `vm.runInNewContext()` first contextifies the given `contextObject` (or
      * creates a new `contextObject` if passed as `undefined`), compiles the `code`,
@@ -374,7 +408,7 @@ declare module 'vm' {
      * @param contextObject An object that will be `contextified`. If `undefined`, a new object will be created.
      * @return the result of the very last statement executed in the script.
      */
-    function runInNewContext(code: string, contextObject?: Context, options?: RunningScriptOptions | string): any;
+    function runInNewContext(code: string, contextObject?: Context, options?: RunningCodeInNewContextOptions | string): any;
     /**
      * `vm.runInThisContext()` compiles `code`, runs it within the context of the
      * current `global` and returns the result. Running code does not have access to
@@ -437,7 +471,7 @@ declare module 'vm' {
      * @param code The JavaScript code to compile and run.
      * @return the result of the very last statement executed in the script.
      */
-    function runInThisContext(code: string, options?: RunningScriptOptions | string): any;
+    function runInThisContext(code: string, options?: RunningCodeOptions | string): any;
     /**
      * Compiles the given code into the provided context (if no context is
      * supplied, the current context is used), and returns it wrapped inside a
@@ -446,7 +480,11 @@ declare module 'vm' {
      * @param code The body of the function to compile.
      * @param params An array of strings containing all parameters for the function.
      */
-    function compileFunction(code: string, params?: ReadonlyArray<string>, options?: CompileFunctionOptions): Function;
+    function compileFunction(code: string, params?: ReadonlyArray<string>, options?: CompileFunctionOptions): Function & {
+        cachedData?: Script['cachedData'] | undefined;
+        cachedDataProduced?: Script['cachedDataProduced'] | undefined;
+        cachedDataRejected?: Script['cachedDataRejected'] | undefined;
+    };
     /**
      * Measure the memory known to V8 and used by all contexts known to the
      * current V8 isolate, or the main context.
@@ -503,6 +541,103 @@ declare module 'vm' {
      * @experimental
      */
     function measureMemory(options?: MeasureMemoryOptions): Promise<MemoryMeasurement>;
+
+    interface ModuleEvaluateOptions {
+        timeout?: RunningScriptOptions['timeout'] | undefined;
+        breakOnSigint?: RunningScriptOptions['breakOnSigint'] | undefined;
+    }
+    type ModuleLinker = (specifier: string, referencingModule: Module, extra: { assert: Object }) => Module | Promise<Module>;
+    type ModuleStatus = 'unlinked' | 'linking' | 'linked' | 'evaluating' | 'evaluated' | 'errored';
+    class Module {
+        /**
+         * The specifiers of all dependencies of this module.
+         */
+        dependencySpecifiers: readonly string[];
+        /**
+         * If the `module.status` is `'errored'`, this property contains the exception thrown by the module during evaluation.
+         * If the status is anything else, accessing this property will result in a thrown exception.
+         */
+        error: any;
+        /**
+         * The identifier of the current module, as set in the constructor.
+         */
+        identifier: string;
+        context: Context;
+        /**
+         * The namespace object of the module. This is only available after linking (`module.link()`) has completed.
+         */
+        namespace: Object;
+        /**
+         * The current status of the module.
+         */
+        status: ModuleStatus;
+        /**
+         * Evaluate the module.
+         *
+         * This must be called after the module has been linked; otherwise it will reject
+         * It could be called also when the module has already been evaluated, in which case it will either do nothing
+         * if the initial evaluation ended in success (`module.status` is `'evaluated'`) or it will re-throw the exception
+         * that the initial evaluation resulted in (`module.status` is `'errored'`).
+         *
+         * This method cannot be called while the module is being evaluated (`module.status` is `'evaluating'`).
+         */
+        evaluate(options?: ModuleEvaluateOptions): Promise<void>;
+        /**
+         * Link module dependencies. This method must be called before evaluation, and can only be called once per module.
+         */
+        link(linker: ModuleLinker): Promise<void>;
+    }
+
+    interface SourceTextModuleOptions {
+        /**
+         * String used in stack traces.
+         * @default 'vm:module(i)' where i is a context-specific ascending index.
+         */
+        identifier?: string | undefined;
+        cachedData?: ScriptOptions['cachedData'] | undefined;
+        context?: Context | undefined;
+        lineOffset?: BaseOptions['lineOffset'] | undefined;
+        columnOffset?: BaseOptions['columnOffset'] | undefined;
+        /**
+         * Called during evaluation of this module to initialize the `import.meta`.
+         */
+        initializeImportMeta?: ((meta: ImportMeta, module: SourceTextModule) => void) | undefined;
+        importModuleDynamically?: ScriptOptions['importModuleDynamically'] | undefined;
+    }
+    class SourceTextModule extends Module {
+        /**
+         * Creates a new `SourceTextModule` instance.
+         * @param code JavaScript Module code to parse
+         */
+        constructor(code: string, options?: SourceTextModuleOptions);
+    }
+
+    interface SyntheticModuleOptions {
+        /**
+         * String used in stack traces.
+         * @default 'vm:module(i)' where i is a context-specific ascending index.
+         */
+        identifier?: string | undefined;
+        /**
+         * The contextified object as returned by the `vm.createContext()` method, to compile and evaluate this module in.
+         */
+        context?: Context | undefined;
+    }
+    class SyntheticModule extends Module {
+        /**
+         * Creates a new `SyntheticModule` instance.
+         * @param exportNames Array of names that will be exported from the module.
+         * @param evaluateCallback Called when the module is evaluated.
+         */
+        constructor(exportNames: string[], evaluateCallback: (this: SyntheticModule) => void, options?: SyntheticModuleOptions);
+        /**
+         * This method is used after the module is linked to set the values of exports.
+         * If it is called before the module is linked, an `ERR_VM_MODULE_STATUS` error will be thrown.
+         * @param name
+         * @param value
+         */
+        setExport(name: string, value: any): void;
+    }
 }
 declare module 'node:vm' {
     export * from 'vm';

node/v8.d.ts

@@ -390,6 +390,57 @@ declare module 'v8' {
      * @since v15.1.0, v14.18.0, v12.22.0
      */
     function stopCoverage(): void;
+
+    /**
+     * This API collects GC data in current thread.
+     */
+    class GCProfiler {
+        /**
+         * Start collecting GC data.
+         */
+        start(): void;
+        /**
+         * Stop collecting GC data and return a object.
+         */
+        stop(): GCProfilerResult;
+    }
+    interface GCProfilerResult {
+        version: number;
+        startTime: number;
+        endTime: number;
+        statistics: Array<{
+            gcType: string;
+            cost: number;
+            beforeGC: {
+                heapStatistics: HeapStatistics;
+                heapSpaceStatistics: HeapSpaceStatistics[];
+            };
+            afterGC: {
+                heapStatistics: HeapStatistics;
+                heapSpaceStatistics: HeapSpaceStatistics[];
+            };
+        }>;
+    }
+    interface HeapStatistics {
+        totalHeapSize: number;
+        totalHeapSizeExecutable: number;
+        totalPhysicalSize: number;
+        totalAvailableSize: number;
+        totalGlobalHandlesSize: number;
+        usedGlobalHandlesSize: number;
+        usedHeapSize: number;
+        heapSizeLimit: number;
+        mallocedMemory: number;
+        externalMemory: number;
+        peakMallocedMemory: number;
+    }
+    interface HeapSpaceStatistics {
+        spaceName: string;
+        spaceSize: number;
+        spaceUsedSize: number;
+        spaceAvailableSize: number;
+        physicalSpaceSize: number;
+    }
 }
 declare module 'node:v8' {
     export * from 'v8';

node/vm.d.ts

@@ -56,11 +56,17 @@ declare module 'vm' {
         columnOffset?: number | undefined;
     }
     interface ScriptOptions extends BaseOptions {
-        displayErrors?: boolean | undefined;
-        timeout?: number | undefined;
-        cachedData?: Buffer | undefined;
+        /**
+         * V8's code cache data for the supplied source.
+         */
+        cachedData?: Buffer | NodeJS.ArrayBufferView | undefined;
         /** @deprecated in favor of `script.createCachedData()` */
         produceCachedData?: boolean | undefined;
+        /**
+         * Called during evaluation of this module when `import()` is called.
+         * If this option is not specified, calls to `import()` will reject with `ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING`.
+         */
+        importModuleDynamically?: ((specifier: string, script: Script, importAssertions: Object) => Module) | undefined;
     }
     interface RunningScriptOptions extends BaseOptions {
         /**
@@ -80,10 +86,31 @@ declare module 'vm' {
          * Default: `false`.
          */
         breakOnSigint?: boolean | undefined;
+    }
+    interface RunningScriptInNewContextOptions extends RunningScriptOptions {
+        /**
+         * Human-readable name of the newly created context.
+         */
+        contextName?: CreateContextOptions['name'];
+        /**
+         * Origin corresponding to the newly created context for display purposes. The origin should be formatted like a URL,
+         * but with only the scheme, host, and port (if necessary), like the value of the `url.origin` property of a `URL` object.
+         * Most notably, this string should omit the trailing slash, as that denotes a path.
+         */
+        contextOrigin?: CreateContextOptions['origin'];
+        contextCodeGeneration?: CreateContextOptions['codeGeneration'];
         /**
          * If set to `afterEvaluate`, microtasks will be run immediately after the script has run.
          */
-        microtaskMode?: 'afterEvaluate' | undefined;
+        microtaskMode?: CreateContextOptions['microtaskMode'];
+    }
+    interface RunningCodeOptions extends RunningScriptOptions {
+        cachedData?: ScriptOptions['cachedData'];
+        importModuleDynamically?: ScriptOptions['importModuleDynamically'];
+    }
+    interface RunningCodeInNewContextOptions extends RunningScriptInNewContextOptions {
+        cachedData?: ScriptOptions['cachedData'];
+        importModuleDynamically?: ScriptOptions['importModuleDynamically'];
     }
     interface CompileFunctionOptions extends BaseOptions {
         /**
@@ -144,7 +171,10 @@ declare module 'vm' {
          * @default 'summary'
          */
         mode?: MeasureMemoryMode | undefined;
-        context?: Context | undefined;
+        /**
+         * @default 'default'
+         */
+        execution?: 'default' | 'eager' | undefined;
     }
     interface MemoryMeasurement {
         total: {
@@ -158,7 +188,7 @@ declare module 'vm' {
      * @since v0.3.1
      */
     class Script {
-        constructor(code: string, options?: ScriptOptions);
+        constructor(code: string, options?: ScriptOptions | string);
         /**
          * Runs the compiled code contained by the `vm.Script` object within the given`contextifiedObject` and returns the result. Running code does not have access
          * to local scope.
@@ -220,7 +250,7 @@ declare module 'vm' {
          * @param contextObject An object that will be `contextified`. If `undefined`, a new object will be created.
          * @return the result of the very last statement executed in the script.
          */
-        runInNewContext(contextObject?: Context, options?: RunningScriptOptions): any;
+        runInNewContext(contextObject?: Context, options?: RunningScriptInNewContextOptions): any;
         /**
          * Runs the compiled code contained by the `vm.Script` within the context of the
          * current `global` object. Running code does not have access to local scope, but _does_ have access to the current `global` object.
@@ -273,6 +303,10 @@ declare module 'vm' {
         cachedDataProduced?: boolean | undefined;
         cachedDataRejected?: boolean | undefined;
         cachedData?: Buffer | undefined;
+        /**
+         * When the script is compiled from a source that contains a source map magic comment, this property will be set to the URL of the source map.
+         */
+        sourceMapURL?: string | undefined;
     }
     /**
      * If given a `contextObject`, the `vm.createContext()` method will `prepare
@@ -345,7 +379,7 @@ declare module 'vm' {
      * @param contextifiedObject The `contextified` object that will be used as the `global` when the `code` is compiled and run.
      * @return the result of the very last statement executed in the script.
      */
-    function runInContext(code: string, contextifiedObject: Context, options?: RunningScriptOptions | string): any;
+    function runInContext(code: string, contextifiedObject: Context, options?: RunningCodeOptions | string): any;
     /**
      * The `vm.runInNewContext()` first contextifies the given `contextObject` (or
      * creates a new `contextObject` if passed as `undefined`), compiles the `code`,
@@ -374,7 +408,7 @@ declare module 'vm' {
      * @param contextObject An object that will be `contextified`. If `undefined`, a new object will be created.
      * @return the result of the very last statement executed in the script.
      */
-    function runInNewContext(code: string, contextObject?: Context, options?: RunningScriptOptions | string): any;
+    function runInNewContext(code: string, contextObject?: Context, options?: RunningCodeInNewContextOptions | string): any;
     /**
      * `vm.runInThisContext()` compiles `code`, runs it within the context of the
      * current `global` and returns the result. Running code does not have access to
@@ -437,7 +471,7 @@ declare module 'vm' {
      * @param code The JavaScript code to compile and run.
      * @return the result of the very last statement executed in the script.
      */
-    function runInThisContext(code: string, options?: RunningScriptOptions | string): any;
+    function runInThisContext(code: string, options?: RunningCodeOptions | string): any;
     /**
      * Compiles the given code into the provided context (if no context is
      * supplied, the current context is used), and returns it wrapped inside a
@@ -446,7 +480,11 @@ declare module 'vm' {
      * @param code The body of the function to compile.
      * @param params An array of strings containing all parameters for the function.
      */
-    function compileFunction(code: string, params?: ReadonlyArray<string>, options?: CompileFunctionOptions): Function;
+    function compileFunction(code: string, params?: ReadonlyArray<string>, options?: CompileFunctionOptions): Function & {
+        cachedData?: Script['cachedData'] | undefined;
+        cachedDataProduced?: Script['cachedDataProduced'] | undefined;
+        cachedDataRejected?: Script['cachedDataRejected'] | undefined;
+    };
     /**
      * Measure the memory known to V8 and used by all contexts known to the
      * current V8 isolate, or the main context.
@@ -503,6 +541,103 @@ declare module 'vm' {
      * @experimental
      */
     function measureMemory(options?: MeasureMemoryOptions): Promise<MemoryMeasurement>;
+
+    interface ModuleEvaluateOptions {
+        timeout?: RunningScriptOptions['timeout'] | undefined;
+        breakOnSigint?: RunningScriptOptions['breakOnSigint'] | undefined;
+    }
+    type ModuleLinker = (specifier: string, referencingModule: Module, extra: { assert: Object }) => Module | Promise<Module>;
+    type ModuleStatus = 'unlinked' | 'linking' | 'linked' | 'evaluating' | 'evaluated' | 'errored';
+    class Module {
+        /**
+         * The specifiers of all dependencies of this module.
+         */
+        dependencySpecifiers: readonly string[];
+        /**
+         * If the `module.status` is `'errored'`, this property contains the exception thrown by the module during evaluation.
+         * If the status is anything else, accessing this property will result in a thrown exception.
+         */
+        error: any;
+        /**
+         * The identifier of the current module, as set in the constructor.
+         */
+        identifier: string;
+        context: Context;
+        /**
+         * The namespace object of the module. This is only available after linking (`module.link()`) has completed.
+         */
+        namespace: Object;
+        /**
+         * The current status of the module.
+         */
+        status: ModuleStatus;
+        /**
+         * Evaluate the module.
+         *
+         * This must be called after the module has been linked; otherwise it will reject
+         * It could be called also when the module has already been evaluated, in which case it will either do nothing
+         * if the initial evaluation ended in success (`module.status` is `'evaluated'`) or it will re-throw the exception
+         * that the initial evaluation resulted in (`module.status` is `'errored'`).
+         *
+         * This method cannot be called while the module is being evaluated (`module.status` is `'evaluating'`).
+         */
+        evaluate(options?: ModuleEvaluateOptions): Promise<void>;
+        /**
+         * Link module dependencies. This method must be called before evaluation, and can only be called once per module.
+         */
+        link(linker: ModuleLinker): Promise<void>;
+    }
+
+    interface SourceTextModuleOptions {
+        /**
+         * String used in stack traces.
+         * @default 'vm:module(i)' where i is a context-specific ascending index.
+         */
+        identifier?: string | undefined;
+        cachedData?: ScriptOptions['cachedData'] | undefined;
+        context?: Context | undefined;
+        lineOffset?: BaseOptions['lineOffset'] | undefined;
+        columnOffset?: BaseOptions['columnOffset'] | undefined;
+        /**
+         * Called during evaluation of this module to initialize the `import.meta`.
+         */
+        initializeImportMeta?: ((meta: ImportMeta, module: SourceTextModule) => void) | undefined;
+        importModuleDynamically?: ScriptOptions['importModuleDynamically'] | undefined;
+    }
+    class SourceTextModule extends Module {
+        /**
+         * Creates a new `SourceTextModule` instance.
+         * @param code JavaScript Module code to parse
+         */
+        constructor(code: string, options?: SourceTextModuleOptions);
+    }
+
+    interface SyntheticModuleOptions {
+        /**
+         * String used in stack traces.
+         * @default 'vm:module(i)' where i is a context-specific ascending index.
+         */
+        identifier?: string | undefined;
+        /**
+         * The contextified object as returned by the `vm.createContext()` method, to compile and evaluate this module in.
+         */
+        context?: Context | undefined;
+    }
+    class SyntheticModule extends Module {
+        /**
+         * Creates a new `SyntheticModule` instance.
+         * @param exportNames Array of names that will be exported from the module.
+         * @param evaluateCallback Called when the module is evaluated.
+         */
+        constructor(exportNames: string[], evaluateCallback: (this: SyntheticModule) => void, options?: SyntheticModuleOptions);
+        /**
+         * This method is used after the module is linked to set the values of exports.
+         * If it is called before the module is linked, an `ERR_VM_MODULE_STATUS` error will be thrown.
+         * @param name
+         * @param value
+         */
+        setExport(name: string, value: any): void;
+    }
 }
 declare module 'node:vm' {
     export * from 'vm';