@types/node 20.0.0 → 20.1.0

node/ts4.8/timers.d.ts

@@ -6,7 +6,7 @@
  * The timer functions within Node.js implement a similar API as the timers API
  * provided by Web Browsers but use a different internal implementation that is
  * built around the Node.js [Event Loop](https://nodejs.org/en/docs/guides/event-loop-timers-and-nexttick/#setimmediate-vs-settimeout).
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/timers.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/timers.js)
  */
 declare module 'timers' {
     import { Abortable } from 'node:events';
@@ -62,6 +62,13 @@ declare module 'timers' {
                 [Symbol.toPrimitive](): number;
             }
         }
+        /**
+         * Schedules execution of a one-time `callback` after `delay` milliseconds. The `callback` will likely not be invoked in precisely `delay` milliseconds.
+         * Node.js makes no guarantees about the exact timing of when callbacks will fire, nor of their ordering. The callback will be called as close as possible to the time specified.
+         * When `delay` is larger than `2147483647` or less than `1`, the `delay` will be set to `1`. Non-integer delays are truncated to an integer.
+         * If `callback` is not a function, a [TypeError](https://nodejs.org/api/errors.html#class-typeerror) will be thrown.
+         * @since v0.0.1
+         */
         function setTimeout<TArgs extends any[]>(callback: (...args: TArgs) => void, ms?: number, ...args: TArgs): NodeJS.Timeout;
         // util.promisify no rest args compability
         // tslint:disable-next-line void-return

node/ts4.8/tls.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const tls = require('node:tls');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/tls.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/tls.js)
  */
 declare module 'tls' {
     import { X509Certificate } from 'node:crypto';
@@ -637,7 +637,8 @@ declare module 'tls' {
          * used.
          * @since v0.5.3
          * @param hostname A SNI host name or wildcard (e.g. `'*'`)
-         * @param context An object containing any of the possible properties from the {@link createSecureContext} `options` arguments (e.g. `key`, `cert`, `ca`, etc).
+         * @param context An object containing any of the possible properties from the {@link createSecureContext} `options` arguments (e.g. `key`, `cert`, `ca`, etc), or a TLS context object created
+         * with {@link createSecureContext} itself.
          */
         addContext(hostname: string, context: SecureContextOptions): void;
         /**

node/ts4.8/trace_events.d.ts

@@ -94,7 +94,7 @@
  *
  * The features from this module are not available in `Worker` threads.
  * @experimental
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/trace_events.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/trace_events.js)
  */
 declare module 'trace_events' {
     /**

node/ts4.8/tty.d.ts

@@ -21,7 +21,7 @@
  *
  * In most cases, there should be little to no reason for an application to
  * manually create instances of the `tty.ReadStream` and `tty.WriteStream`classes.
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/tty.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/tty.js)
  */
 declare module 'tty' {
     import * as net from 'node:net';

node/ts4.8/url.d.ts

@@ -5,7 +5,7 @@
  * ```js
  * import url from 'node:url';
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/url.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/url.js)
  */
 declare module 'url' {
     import { Blob as NodeBlob } from 'node:buffer';

node/ts4.8/util.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const util = require('node:util');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/util.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/util.js)
  */
 declare module 'util' {
     import * as types from 'node:util/types';
@@ -1834,7 +1834,7 @@ declare module 'util/types' {
      * ```js
      * const vm = require('node:vm');
      * const context = vm.createContext({});
-     * const myError = vm.runInContext('new Error', context);
+     * const myError = vm.runInContext('new Error()', context);
      * console.log(util.types.isNativeError(myError)); // true
      * console.log(myError instanceof Error); // false
      * ```

node/ts4.8/v8.d.ts

@@ -4,7 +4,7 @@
  * ```js
  * const v8 = require('node:v8');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/v8.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/v8.js)
  */
 declare module 'v8' {
     import { Readable } from 'node:stream';
@@ -29,6 +29,9 @@ declare module 'v8' {
         does_zap_garbage: DoesZapCodeSpaceFlag;
         number_of_native_contexts: number;
         number_of_detached_contexts: number;
+        total_global_handles_size: number;
+        used_global_handles_size: number;
+        external_memory: number;
     }
     interface HeapCodeStatistics {
         code_and_metadata_size: number;

node/ts4.8/vm.d.ts

@@ -34,7 +34,7 @@
  *
  * console.log(x); // 1; y is not defined.
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/vm.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/vm.js)
  */
 declare module 'vm' {
     interface Context extends NodeJS.Dict<any> {}

node/ts4.8/wasi.d.ts

@@ -62,7 +62,7 @@
  * $ wat2wasm demo.wat
  * ```
  * @experimental
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/wasi.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/wasi.js)
  */
 declare module 'wasi' {
     interface WASIOptions {
@@ -85,11 +85,11 @@ declare module 'wasi' {
          */
         preopens?: NodeJS.Dict<string> | undefined;
         /**
-         * By default, WASI applications terminate the Node.js
-         * process via the `__wasi_proc_exit()` function. Setting this option to `true`
-         * causes `wasi.start()` to return the exit code rather than terminate the
-         * process.
-         * @default false
+         * By default, when WASI applications call `__wasi_proc_exit()`
+         *  `wasi.start()` will return with the exit code specified rather than terminatng the process.
+         * Setting this option to `false` will cause the Node.js process to exit with
+         * the specified exit code instead.
+         * @default true
          */
         returnOnExit?: boolean | undefined;
         /**

node/ts4.8/worker_threads.d.ts

@@ -49,7 +49,7 @@
  *
  * Worker threads inherit non-process-specific options by default. Refer to `Worker constructor options` to know how to customize worker thread options,
  * specifically `argv` and `execArgv` options.
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/worker_threads.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/worker_threads.js)
  */
 declare module 'worker_threads' {
     import { Blob } from 'node:buffer';

node/ts4.8/zlib.d.ts

@@ -88,7 +88,7 @@
  *   });
  * ```
  * @since v0.5.8
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/zlib.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/zlib.js)
  */
 declare module 'zlib' {
     import * as stream from 'node:stream';

node/tty.d.ts

@@ -21,7 +21,7 @@
  *
  * In most cases, there should be little to no reason for an application to
  * manually create instances of the `tty.ReadStream` and `tty.WriteStream`classes.
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/tty.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/tty.js)
  */
 declare module 'tty' {
     import * as net from 'node:net';

node/url.d.ts

@@ -5,7 +5,7 @@
  * ```js
  * import url from 'node:url';
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/url.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/url.js)
  */
 declare module 'url' {
     import { Blob as NodeBlob } from 'node:buffer';

node/util.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const util = require('node:util');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/util.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/util.js)
  */
 declare module 'util' {
     import * as types from 'node:util/types';
@@ -1842,7 +1842,7 @@ declare module 'util/types' {
      * ```js
      * const vm = require('node:vm');
      * const context = vm.createContext({});
-     * const myError = vm.runInContext('new Error', context);
+     * const myError = vm.runInContext('new Error()', context);
      * console.log(util.types.isNativeError(myError)); // true
      * console.log(myError instanceof Error); // false
      * ```

node/v8.d.ts

@@ -4,7 +4,7 @@
  * ```js
  * const v8 = require('node:v8');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/v8.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/v8.js)
  */
 declare module 'v8' {
     import { Readable } from 'node:stream';

node/vm.d.ts

@@ -34,7 +34,7 @@
  *
  * console.log(x); // 1; y is not defined.
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/vm.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/vm.js)
  */
 declare module 'vm' {
     interface Context extends NodeJS.Dict<any> {}

node/wasi.d.ts

@@ -62,7 +62,7 @@
  * $ wat2wasm demo.wat
  * ```
  * @experimental
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/wasi.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/wasi.js)
  */
 declare module 'wasi' {
     interface WASIOptions {
@@ -85,11 +85,11 @@ declare module 'wasi' {
          */
         preopens?: NodeJS.Dict<string> | undefined;
         /**
-         * By default, WASI applications terminate the Node.js
-         * process via the `__wasi_proc_exit()` function. Setting this option to `true`
-         * causes `wasi.start()` to return the exit code rather than terminate the
-         * process.
-         * @default false
+         * By default, when WASI applications call `__wasi_proc_exit()`
+         *  `wasi.start()` will return with the exit code specified rather than terminatng the process.
+         * Setting this option to `false` will cause the Node.js process to exit with
+         * the specified exit code instead.
+         * @default true
          */
         returnOnExit?: boolean | undefined;
         /**

node/worker_threads.d.ts

@@ -49,7 +49,7 @@
  *
  * Worker threads inherit non-process-specific options by default. Refer to `Worker constructor options` to know how to customize worker thread options,
  * specifically `argv` and `execArgv` options.
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/worker_threads.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/worker_threads.js)
  */
 declare module 'worker_threads' {
     import { Blob } from 'node:buffer';

node/zlib.d.ts

@@ -88,7 +88,7 @@
  *   });
  * ```
  * @since v0.5.8
- * @see [source](https://github.com/nodejs/node/blob/v20.0.0/lib/zlib.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.1.0/lib/zlib.js)
  */
 declare module 'zlib' {
     import * as stream from 'node:stream';