@types/node 18.15.12 → 18.16.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: Wed, 19 Apr 2023 23:02:48 GMT
+ * Last updated: Sun, 23 Apr 2023 05:02:41 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`, `structuredClone`
 

node/async_hooks.d.ts

@@ -319,16 +319,6 @@ declare module 'async_hooks' {
          */
         triggerAsyncId(): number;
     }
-    interface AsyncLocalStorageOptions<T> {
-        /**
-         * Optional callback invoked before a store is propagated to a new async resource.
-         * Returning `true` allows propagation, returning `false` avoids it. Default is to propagate always.
-         * @param type The type of async event.
-         * @param store The current store.
-         * @since v18.13.0
-         */
-        onPropagate?: ((type: string, store: T) => boolean) | undefined;
-    }
     /**
      * This class creates stores that stay coherent through asynchronous operations.
      *
@@ -378,8 +368,23 @@ declare module 'async_hooks' {
      * @since v13.10.0, v12.17.0
      */
     class AsyncLocalStorage<T> {
-        constructor(options?: AsyncLocalStorageOptions<T>);
-
+        /**
+         * Binds the given function to the current execution context.
+         * @since v18.16.0
+         * @param fn The function to bind to the current execution context.
+         * @returns A new function that calls `fn` within the captured execution context.
+         */
+        static bind<Func extends (...args: any[]) => any>(fn: Func): Func & {
+            asyncResource: AsyncResource;
+        };
+        /**
+         * Captures the current execution context and returns a function that accepts a function as an argument.
+         * Whenever the returned function is called, it calls the function passed to it within the captured context.
+         * @since v18.16.0
+         */
+        static snapshot(): (<R, TArgs extends any[]>(fn: (...args: TArgs) => R, ...args: TArgs) => R) & {
+            asyncResource: AsyncResource;
+        };
         /**
          * Disables the instance of `AsyncLocalStorage`. All subsequent calls
          * to `asyncLocalStorage.getStore()` will return `undefined` until`asyncLocalStorage.run()` or `asyncLocalStorage.enterWith()` is called again.

node/buffer.d.ts

@@ -427,6 +427,14 @@ declare module 'buffer' {
              * @param totalLength Total length of the `Buffer` instances in `list` when concatenated.
              */
             concat(list: ReadonlyArray<Uint8Array>, totalLength?: number): Buffer;
+            /**
+             * Copies the underlying memory of `view` into a new `Buffer`.
+             * @since v18.16.0
+             * @param view The `TypedArray` to copy.
+             * @param offset The starting offset within `view`.
+             * @param length The number of elements from `view` to copy.
+             */
+            copyBytesFrom(view: NodeJS.TypedArray, offset?: number, length?: number): Buffer;
             /**
              * Compares `buf1` to `buf2`, typically for the purpose of sorting arrays of`Buffer` instances. This is equivalent to calling `buf1.compare(buf2)`.
              *

node/events.d.ts

@@ -610,10 +610,14 @@ declare module 'events' {
                 emit(eventName: string | symbol, ...args: any[]): boolean;
                 /**
                  * Returns the number of listeners listening to the event named `eventName`.
+                 *
+                 * If `listener` is provided, it will return how many times the listener
+                 * is found in the list of the listeners of the event.
                  * @since v3.2.0
                  * @param eventName The name of the event being listened for
+                 * @param listener The event handler function
                  */
-                listenerCount(eventName: string | symbol): number;
+                listenerCount(eventName: string | symbol, listener?: Function): number;
                 /**
                  * Adds the `listener` function to the _beginning_ of the listeners array for the
                  * event named `eventName`. No checks are made to see if the `listener` has

node/globals.d.ts

@@ -63,6 +63,7 @@ interface AbortSignal extends EventTarget {
      */
     readonly aborted: boolean;
     readonly reason: any;
+    onabort: null | ((this: AbortSignal, event: Event) => any);
 }
 
 declare var AbortController: typeof globalThis extends {onmessage: any; AbortController: infer T}

node/index.d.ts

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

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "18.15.12",
+    "version": "18.16.0",
     "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": "073cca51adb608444e55491359ddfc342818394742589fd17722e68ed00ee4fa",
+    "typesPublisherContentHash": "a33ada7d817296d3a0955f57b75fdf38201a158b99b66db3bb81316dfddd470b",
     "typeScriptVersion": "4.3"
 }

node/tls.d.ts

@@ -768,12 +768,9 @@ declare module 'tls' {
          */
         crl?: string | Buffer | Array<string | Buffer> | undefined;
         /**
-         * Diffie Hellman parameters, required for Perfect Forward Secrecy. Use
-         * openssl dhparam to create the parameters. The key length must be
-         * greater than or equal to 1024 bits or else an error will be thrown.
-         * Although 1024 bits is permissible, use 2048 bits or larger for
-         * stronger security. If omitted or invalid, the parameters are
-         * silently discarded and DHE ciphers will not be available.
+         * `'auto'` or custom Diffie-Hellman parameters, required for non-ECDHE perfect forward secrecy.
+         * If omitted or invalid, the parameters are silently discarded and DHE ciphers will not be available.
+         * ECDHE-based perfect forward secrecy will still be available.
          */
         dhparam?: string | Buffer | undefined;
         /**

node/ts4.8/async_hooks.d.ts

@@ -319,16 +319,6 @@ declare module 'async_hooks' {
          */
         triggerAsyncId(): number;
     }
-    interface AsyncLocalStorageOptions<T> {
-        /**
-         * Optional callback invoked before a store is propagated to a new async resource.
-         * Returning `true` allows propagation, returning `false` avoids it. Default is to propagate always.
-         * @param type The type of async event.
-         * @param store The current store.
-         * @since v18.13.0
-         */
-        onPropagate?: ((type: string, store: T) => boolean) | undefined;
-    }
     /**
      * This class creates stores that stay coherent through asynchronous operations.
      *
@@ -378,8 +368,23 @@ declare module 'async_hooks' {
      * @since v13.10.0, v12.17.0
      */
     class AsyncLocalStorage<T> {
-        constructor(options?: AsyncLocalStorageOptions<T>);
-
+        /**
+         * Binds the given function to the current execution context.
+         * @since v18.16.0
+         * @param fn The function to bind to the current execution context.
+         * @returns A new function that calls `fn` within the captured execution context.
+         */
+        static bind<Func extends (...args: any[]) => any>(fn: Func): Func & {
+            asyncResource: AsyncResource;
+        };
+        /**
+         * Captures the current execution context and returns a function that accepts a function as an argument.
+         * Whenever the returned function is called, it calls the function passed to it within the captured context.
+         * @since v18.16.0
+         */
+        static snapshot(): (<R, TArgs extends any[]>(fn: (...args: TArgs) => R, ...args: TArgs) => R) & {
+            asyncResource: AsyncResource;
+        };
         /**
          * Disables the instance of `AsyncLocalStorage`. All subsequent calls
          * to `asyncLocalStorage.getStore()` will return `undefined` until`asyncLocalStorage.run()` or `asyncLocalStorage.enterWith()` is called again.

node/ts4.8/buffer.d.ts

@@ -200,8 +200,7 @@ declare module 'buffer' {
     import { Blob as NodeBlob } from 'buffer';
     // This conditional type will be the existing global Blob in a browser, or
     // the copy below in a Node environment.
-    type __Blob = typeof globalThis extends { onmessage: any; Blob: any } ? {} : NodeBlob;
-
+    type __Blob = typeof globalThis extends { onmessage: any; Blob: infer T } ? T : NodeBlob;
     global {
         // Buffer class
         type BufferEncoding =
@@ -428,6 +427,14 @@ declare module 'buffer' {
              * @param totalLength Total length of the `Buffer` instances in `list` when concatenated.
              */
             concat(list: ReadonlyArray<Uint8Array>, totalLength?: number): Buffer;
+            /**
+             * Copies the underlying memory of `view` into a new `Buffer`.
+             * @since v18.16.0
+             * @param view The `TypedArray` to copy.
+             * @param offset The starting offset within `view`.
+             * @param length The number of elements from `view` to copy.
+             */
+            copyBytesFrom(view: NodeJS.TypedArray, offset?: number, length?: number): Buffer;
             /**
              * Compares `buf1` to `buf2`, typically for the purpose of sorting arrays of`Buffer` instances. This is equivalent to calling `buf1.compare(buf2)`.
              *

node/ts4.8/events.d.ts

@@ -610,10 +610,14 @@ declare module 'events' {
                 emit(eventName: string | symbol, ...args: any[]): boolean;
                 /**
                  * Returns the number of listeners listening to the event named `eventName`.
+                 *
+                 * If `listener` is provided, it will return how many times the listener
+                 * is found in the list of the listeners of the event.
                  * @since v3.2.0
                  * @param eventName The name of the event being listened for
+                 * @param listener The event handler function
                  */
-                listenerCount(eventName: string | symbol): number;
+                listenerCount(eventName: string | symbol, listener?: Function): number;
                 /**
                  * Adds the `listener` function to the _beginning_ of the listeners array for the
                  * event named `eventName`. No checks are made to see if the `listener` has

node/ts4.8/globals.d.ts

@@ -45,35 +45,42 @@ declare var gc: undefined | (() => void);
 // from https://github.com/microsoft/TypeScript/blob/38da7c600c83e7b31193a62495239a0fe478cb67/lib/lib.webworker.d.ts#L633 until moved to separate lib
 /** A controller object that allows you to abort one or more DOM requests as and when desired. */
 interface AbortController {
-    /**
-     * Returns the AbortSignal object associated with this object.
-     */
-
-    readonly signal: AbortSignal;
-    /**
-     * Invoking this method will set this object's AbortSignal's aborted flag and signal to any observers that the associated activity is to be aborted.
-     */
-    abort(reason?: any): void;
+  /**
+   * Returns the AbortSignal object associated with this object.
+   */
+
+  readonly signal: AbortSignal;
+  /**
+   * Invoking this method will set this object's AbortSignal's aborted flag and signal to any observers that the associated activity is to be aborted.
+   */
+  abort(reason?: any): void;
 }
 
 /** A signal object that allows you to communicate with a DOM request (such as a Fetch) and abort it if required via an AbortController object. */
 interface AbortSignal extends EventTarget {
-    /**
-     * Returns true if this AbortSignal's AbortController has signaled to abort, and false otherwise.
-     */
-    readonly aborted: boolean;
+  /**
+   * Returns true if this AbortSignal's AbortController has signaled to abort, and false otherwise.
+   */
+  readonly aborted: boolean;
+  readonly reason: any;
+  onabort: null | ((this: AbortSignal, event: Event) => any);
 }
 
-declare var AbortController: {
-    prototype: AbortController;
-    new(): AbortController;
-};
-
-declare var AbortSignal: {
-    prototype: AbortSignal;
-    new(): AbortSignal;
-    // TODO: Add abort() static
-};
+declare var AbortController: typeof globalThis extends {onmessage: any; AbortController: infer T}
+  ? T
+  : {
+      prototype: AbortController;
+      new(): AbortController;
+  };
+
+declare var AbortSignal: typeof globalThis extends {onmessage: any; AbortSignal: infer T}
+  ? T
+  : {
+      prototype: AbortSignal;
+      new(): AbortSignal;
+      abort(reason?: any): AbortSignal;
+      timeout(milliseconds: number): AbortSignal;
+  };
 //#endregion borrowed
 
 //#region ArrayLike.at()

node/ts4.8/tls.d.ts

@@ -768,12 +768,9 @@ declare module 'tls' {
          */
         crl?: string | Buffer | Array<string | Buffer> | undefined;
         /**
-         * Diffie Hellman parameters, required for Perfect Forward Secrecy. Use
-         * openssl dhparam to create the parameters. The key length must be
-         * greater than or equal to 1024 bits or else an error will be thrown.
-         * Although 1024 bits is permissible, use 2048 bits or larger for
-         * stronger security. If omitted or invalid, the parameters are
-         * silently discarded and DHE ciphers will not be available.
+         * `'auto'` or custom Diffie-Hellman parameters, required for non-ECDHE perfect forward secrecy.
+         * If omitted or invalid, the parameters are silently discarded and DHE ciphers will not be available.
+         * ECDHE-based perfect forward secrecy will still be available.
          */
         dhparam?: string | Buffer | undefined;
         /**

node/ts4.8/url.d.ts

@@ -833,6 +833,11 @@ declare module 'url' {
          * ```
          */
         set(name: string, value: string): void;
+        /**
+         * The total number of parameter entries.
+         * @since v18.16.0
+         */
+        readonly size: number;
         /**
          * Sort all existing name-value pairs in-place by their names. Sorting is done
          * with a [stable sorting algorithm](https://en.wikipedia.org/wiki/Sorting_algorithm#Stability), so relative order between name-value pairs

node/ts4.8/util.d.ts

@@ -225,6 +225,12 @@ declare module 'util' {
      * @returns The same AbortSignal
      */
     export function transferableAbortSignal(signal: AbortSignal): AbortSignal;
+    /**
+     * Listens to abort event on the provided `signal` and returns a promise that is fulfilled when the `signal` is aborted.
+     * If the passed `resource` is garbage collected before the `signal` is aborted, the returned promise shall remain pending indefinitely.
+     * @param resource  Any non-null entity, reference to which is held weakly.
+     */
+    export function aborted(signal: AbortSignal, resource: any): Promise<void>;
     /**
      * The `util.inspect()` method returns a string representation of `object` that is
      * intended for debugging. The output of `util.inspect` may change at any time

node/ts4.8/worker_threads.d.ts

@@ -262,6 +262,12 @@ declare module 'worker_threads' {
          * @default true
          */
         trackUnmanagedFds?: boolean | undefined;
+        /**
+         * An optional `name` to be appended to the worker title
+         * for debuggin/identification purposes, making the final title as
+         * `[worker ${id}] ${name}`.
+         */
+        name?: string | undefined;
     }
     interface ResourceLimits {
         /**

node/url.d.ts

@@ -833,6 +833,11 @@ declare module 'url' {
          * ```
          */
         set(name: string, value: string): void;
+        /**
+         * The total number of parameter entries.
+         * @since v18.16.0
+         */
+        readonly size: number;
         /**
          * Sort all existing name-value pairs in-place by their names. Sorting is done
          * with a [stable sorting algorithm](https://en.wikipedia.org/wiki/Sorting_algorithm#Stability), so relative order between name-value pairs

node/util.d.ts

@@ -225,6 +225,12 @@ declare module 'util' {
      * @returns The same AbortSignal
      */
     export function transferableAbortSignal(signal: AbortSignal): AbortSignal;
+    /**
+     * Listens to abort event on the provided `signal` and returns a promise that is fulfilled when the `signal` is aborted.
+     * If the passed `resource` is garbage collected before the `signal` is aborted, the returned promise shall remain pending indefinitely.
+     * @param resource  Any non-null entity, reference to which is held weakly.
+     */
+    export function aborted(signal: AbortSignal, resource: any): Promise<void>;
     /**
      * The `util.inspect()` method returns a string representation of `object` that is
      * intended for debugging. The output of `util.inspect` may change at any time

node/worker_threads.d.ts

@@ -262,6 +262,12 @@ declare module 'worker_threads' {
          * @default true
          */
         trackUnmanagedFds?: boolean | undefined;
+        /**
+         * An optional `name` to be appended to the worker title
+         * for debuggin/identification purposes, making the final title as
+         * `[worker ${id}] ${name}`.
+         */
+        name?: string | undefined;
     }
     interface ResourceLimits {
         /**