@types/node 18.17.10 → 18.17.12

node v18.17/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/v18.
 
 ### Additional Details
- * Last updated: Thu, 24 Aug 2023 21:33:09 GMT
+ * Last updated: Mon, 28 Aug 2023 00:33:01 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`, `structuredClone`
 

node v18.17/module.d.ts

@@ -79,6 +79,9 @@ declare module 'module' {
              */
             findEntry(line: number, column: number): SourceMapping;
         }
+        interface ImportAssertions extends NodeJS.Dict<string> {
+            type?: string | undefined;
+        }
         type ModuleFormat = 'builtin' | 'commonjs' | 'json' | 'module' | 'wasm';
         type ModuleSource = string | ArrayBuffer | NodeJS.TypedArray;
         interface GlobalPreloadContext {
@@ -100,7 +103,7 @@ declare module 'module' {
             /**
              *  An object whose key-value pairs represent the assertions for the module to import
              */
-            importAssertions: Object;
+            importAssertions: ImportAssertions;
             /**
              * The module importing this one, or undefined if this is the Node.js entry point
              */
@@ -114,7 +117,7 @@ declare module 'module' {
             /**
              * The import assertions to use when caching the module (optional; if excluded the input will be used)
              */
-            importAssertions?: Object | undefined;
+            importAssertions?: ImportAssertions | undefined;
             /**
              * A signal that this hook intends to terminate the chain of `resolve` hooks.
              * @default false
@@ -137,7 +140,7 @@ declare module 'module' {
         type ResolveHook = (
             specifier: string,
             context: ResolveHookContext,
-            nextResolve: (specifier: string, context?: ResolveHookContext) => ResolveFnOutput
+            nextResolve: (specifier: string, context?: ResolveHookContext) => ResolveFnOutput | Promise<ResolveFnOutput>
         ) => ResolveFnOutput | Promise<ResolveFnOutput>;
         interface LoadHookContext {
             /**
@@ -151,7 +154,7 @@ declare module 'module' {
             /**
              *  An object whose key-value pairs represent the assertions for the module to import
              */
-            importAssertions: Object;
+            importAssertions: ImportAssertions;
         }
         interface LoadFnOutput {
             format: ModuleFormat;
@@ -173,7 +176,11 @@ declare module 'module' {
          * @param context Metadata about the module
          * @param nextLoad The subsequent `load` hook in the chain, or the Node.js default `load` hook after the last user-supplied `load` hook
          */
-        type LoadHook = (url: string, context: LoadHookContext, nextLoad: (url: string, context?: LoadHookContext) => LoadFnOutput) => LoadFnOutput | Promise<LoadFnOutput>;
+        type LoadHook = (
+            url: string,
+            context: LoadHookContext,
+            nextLoad: (url: string, context?: LoadHookContext) => LoadFnOutput | Promise<LoadFnOutput>
+        ) => LoadFnOutput | Promise<LoadFnOutput>;
     }
     interface Module extends NodeModule {}
     class Module {

node v18.17/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "18.17.10",
+    "version": "18.17.12",
     "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": "e7d4c795a67a90f21fdfacae6ed2b4127ad04555d1acd5c2340fc8621582a606",
+    "typesPublisherContentHash": "42b2e48cacb4776d62b695deffaffacdaf029bcaa951a0a2ff1cbec3e8b7e01f",
     "typeScriptVersion": "4.3"
 }

node v18.17/test.d.ts

@@ -167,9 +167,8 @@ declare module 'node:test' {
 
     /**
      * The type of a function under Suite.
-     * If the test uses callbacks, the callback function is passed as an argument
      */
-    type SuiteFn = (done: (result?: any) => void) => void;
+    type SuiteFn = (s: SuiteContext) => void | Promise<void>;
 
     interface RunOptions {
         /**
@@ -386,6 +385,24 @@ declare module 'node:test' {
         readonly mock: MockTracker;
     }
 
+    /**
+     * An instance of `SuiteContext` is passed to each suite function in order to
+     * interact with the test runner. However, the `SuiteContext` constructor is not
+     * exposed as part of the API.
+     * @since v18.7.0, v16.17.0
+     */
+    class SuiteContext {
+        /**
+         * The name of the suite.
+         * @since v18.8.0, v16.18.0
+         */
+        readonly name: string;
+        /**
+         * Can be used to abort test subtasks when the test has been aborted.
+         * @since v18.7.0, v16.17.0
+         */
+        readonly signal: AbortSignal;
+    }
     interface TestOptions {
         /**
          * If a number is provided, then that many tests would run in parallel.
@@ -473,7 +490,7 @@ declare module 'node:test' {
      * The hook function. If the hook uses callbacks, the callback function is passed as the
      * second argument.
      */
-    type HookFn = (done: (result?: any) => void) => any;
+    type HookFn = (s: SuiteContext, done: (result?: any) => void) => any;
 
     /**
      * Configuration options for hooks.

node v18.17/ts4.8/module.d.ts

@@ -79,6 +79,9 @@ declare module 'module' {
              */
             findEntry(line: number, column: number): SourceMapping;
         }
+        interface ImportAssertions extends NodeJS.Dict<string> {
+            type?: string | undefined;
+        }
         type ModuleFormat = 'builtin' | 'commonjs' | 'json' | 'module' | 'wasm';
         type ModuleSource = string | ArrayBuffer | NodeJS.TypedArray;
         interface GlobalPreloadContext {
@@ -100,7 +103,7 @@ declare module 'module' {
             /**
              *  An object whose key-value pairs represent the assertions for the module to import
              */
-            importAssertions: Object;
+            importAssertions: ImportAssertions;
             /**
              * The module importing this one, or undefined if this is the Node.js entry point
              */
@@ -114,7 +117,7 @@ declare module 'module' {
             /**
              * The import assertions to use when caching the module (optional; if excluded the input will be used)
              */
-            importAssertions?: Object | undefined;
+            importAssertions?: ImportAssertions | undefined;
             /**
              * A signal that this hook intends to terminate the chain of `resolve` hooks.
              * @default false
@@ -137,7 +140,7 @@ declare module 'module' {
         type ResolveHook = (
             specifier: string,
             context: ResolveHookContext,
-            nextResolve: (specifier: string, context?: ResolveHookContext) => ResolveFnOutput
+            nextResolve: (specifier: string, context?: ResolveHookContext) => ResolveFnOutput | Promise<ResolveFnOutput>
         ) => ResolveFnOutput | Promise<ResolveFnOutput>;
         interface LoadHookContext {
             /**
@@ -151,7 +154,7 @@ declare module 'module' {
             /**
              *  An object whose key-value pairs represent the assertions for the module to import
              */
-            importAssertions: Object;
+            importAssertions: ImportAssertions;
         }
         interface LoadFnOutput {
             format: ModuleFormat;
@@ -173,7 +176,11 @@ declare module 'module' {
          * @param context Metadata about the module
          * @param nextLoad The subsequent `load` hook in the chain, or the Node.js default `load` hook after the last user-supplied `load` hook
          */
-        type LoadHook = (url: string, context: LoadHookContext, nextLoad: (url: string, context?: LoadHookContext) => LoadFnOutput) => LoadFnOutput | Promise<LoadFnOutput>;
+        type LoadHook = (
+            url: string,
+            context: LoadHookContext,
+            nextLoad: (url: string, context?: LoadHookContext) => LoadFnOutput | Promise<LoadFnOutput>
+        ) => LoadFnOutput | Promise<LoadFnOutput>;
     }
     interface Module extends NodeModule {}
     class Module {

node v18.17/ts4.8/test.d.ts

@@ -166,9 +166,8 @@ declare module 'node:test' {
 
     /**
      * The type of a function under Suite.
-     * If the test uses callbacks, the callback function is passed as an argument
      */
-    type SuiteFn = (done: (result?: any) => void) => void;
+    type SuiteFn = (s: SuiteContext) => void | Promise<void>;
 
     interface RunOptions {
         /**
@@ -372,6 +371,24 @@ declare module 'node:test' {
         readonly mock: MockTracker;
     }
 
+    /**
+     * An instance of `SuiteContext` is passed to each suite function in order to
+     * interact with the test runner. However, the `SuiteContext` constructor is not
+     * exposed as part of the API.
+     * @since v18.7.0, v16.17.0
+     */
+    class SuiteContext {
+        /**
+         * The name of the suite.
+         * @since v18.8.0, v16.18.0
+         */
+        readonly name: string;
+        /**
+         * Can be used to abort test subtasks when the test has been aborted.
+         * @since v18.7.0, v16.17.0
+         */
+        readonly signal: AbortSignal;
+    }
     interface TestOptions {
         /**
          * If a number is provided, then that many tests would run in parallel.
@@ -459,7 +476,7 @@ declare module 'node:test' {
      * The hook function. If the hook uses callbacks, the callback function is passed as the
      * second argument.
      */
-    type HookFn = (done: (result?: any) => void) => any;
+    type HookFn = (s: SuiteContext, done: (result?: any) => void) => any;
 
     /**
      * Configuration options for hooks.

node v18.17/ts4.8/vm.d.ts

@@ -37,6 +37,7 @@
  * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/vm.js)
  */
 declare module 'vm' {
+    import { ImportAssertions } from 'node:module';
     interface Context extends NodeJS.Dict<any> {}
     interface BaseOptions {
         /**
@@ -66,7 +67,7 @@ declare module 'vm' {
          * 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;
+        importModuleDynamically?: ((specifier: string, script: Script, importAssertions: ImportAssertions) => Module) | undefined;
     }
     interface RunningScriptOptions extends BaseOptions {
         /**

node v18.17/vm.d.ts

@@ -37,6 +37,7 @@
  * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/vm.js)
  */
 declare module 'vm' {
+    import { ImportAssertions } from 'node:module';
     interface Context extends NodeJS.Dict<any> {}
     interface BaseOptions {
         /**
@@ -66,7 +67,7 @@ declare module 'vm' {
          * 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;
+        importModuleDynamically?: ((specifier: string, script: Script, importAssertions: ImportAssertions) => Module) | undefined;
     }
     interface RunningScriptOptions extends BaseOptions {
         /**