@types/node 16.6.2 → 16.7.3

node/perf_hooks.d.ts

@@ -26,7 +26,7 @@
  *   performance.measure('A to B', 'A', 'B');
  * });
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/perf_hooks.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/perf_hooks.js)
  */
 declare module 'perf_hooks' {
     import { AsyncResource } from 'node:async_hooks';
@@ -375,7 +375,7 @@ declare module 'perf_hooks' {
          */
         disconnect(): void;
         /**
-         * Subscribes the `<PerformanceObserver>` instance to notifications of new `<PerformanceEntry>` instances identified either by `options.entryTypes`or `options.type`:
+         * Subscribes the `PerformanceObserver` instance to notifications of new `PerformanceEntry` instances identified either by `options.entryTypes`or `options.type`:
          *
          * ```js
          * const {
@@ -545,7 +545,7 @@ declare module 'perf_hooks' {
         figures?: number | undefined;
     }
     /**
-     * Returns a `<RecordableHistogram>`.
+     * Returns a `RecordableHistogram`.
      * @since v15.9.0
      */
     function createHistogram(options?: CreateHistogramOptions): RecordableHistogram;

node/punycode.d.ts

@@ -24,7 +24,7 @@
  * made available to developers as a convenience. Fixes or other modifications to
  * the module must be directed to the [Punycode.js](https://github.com/bestiejs/punycode.js) project.
  * @deprecated Since v7.0.0 - Deprecated
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/punycode.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/punycode.js)
  */
 declare module 'punycode' {
     /**

node/querystring.d.ts

@@ -7,9 +7,9 @@
  * ```
  *
  * The `querystring` API is considered Legacy. While it is still maintained,
- * new code should use the `<URLSearchParams>` API instead.
+ * new code should use the `URLSearchParams` API instead.
  * @deprecated Legacy
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/querystring.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/querystring.js)
  */
 declare module 'querystring' {
     interface StringifyOptions {

node/readline.d.ts

@@ -26,7 +26,7 @@
  *
  * Once this code is invoked, the Node.js application will not terminate until the`readline.Interface` is closed because the interface waits for data to be
  * received on the `input` stream.
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/readline.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/readline.js)
  */
 declare module 'readline' {
     import { Abortable, EventEmitter } from 'node:events';

node/repl.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const repl = require('repl');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/repl.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/repl.js)
  */
 declare module 'repl' {
     import { Interface, Completer, AsyncCompleter } from 'node:readline';

node/stream/web.d.ts

@@ -1,7 +1,6 @@
 declare module 'stream/web' {
     // stub module, pending copy&paste from .d.ts or manual impl
 }
-
 declare module 'node:stream/web' {
     export * from 'stream/web';
 }

node/stream.d.ts

@@ -14,7 +14,7 @@
  *
  * The `stream` module is useful for creating new types of stream instances. It is
  * usually not necessary to use the `stream` module to consume streams.
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/stream.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/stream.js)
  */
 declare module 'stream' {
     import { EventEmitter, Abortable } from 'node:events';
@@ -1007,7 +1007,7 @@ declare module 'stream' {
          * ```
          *
          * The `pipeline` API provides a promise version, which can also
-         * receive an options argument as the last parameter with a`signal` `<AbortSignal>` property. When the signal is aborted,`destroy` will be called on the underlying pipeline, with
+         * receive an options argument as the last parameter with a`signal` `AbortSignal` property. When the signal is aborted,`destroy` will be called on the underlying pipeline, with
          * an`AbortError`.
          *
          * ```js

node/string_decoder.d.ts

@@ -36,7 +36,7 @@
  * decoder.write(Buffer.from([0x82]));
  * console.log(decoder.end(Buffer.from([0xAC])));
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/string_decoder.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/string_decoder.js)
  */
 declare module 'string_decoder' {
     class StringDecoder {

node/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/v16.6.0/lib/timers.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/timers.js)
  */
 declare module 'timers' {
     import { Abortable } from 'node:events';

node/tls.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const tls = require('tls');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/tls.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/tls.js)
  */
 declare module 'tls' {
     import { X509Certificate } from 'node:crypto';
@@ -348,14 +348,14 @@ declare module 'tls' {
          */
         enableTrace(): void;
         /**
-         * Returns the peer certificate as an `<X509Certificate>` object.
+         * Returns the peer certificate as an `X509Certificate` object.
          *
          * If there is no peer certificate, or the socket has been destroyed,`undefined` will be returned.
          * @since v15.9.0
          */
         getPeerX509Certificate(): X509Certificate | undefined;
         /**
-         * Returns the local certificate as an `<X509Certificate>` object.
+         * Returns the local certificate as an `X509Certificate` object.
          *
          * If there is no local certificate, or the socket has been destroyed,`undefined` will be returned.
          * @since v15.9.0

node/trace_events.d.ts

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

node/tty.d.ts

@@ -22,7 +22,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/v16.6.0/lib/tty.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/tty.js)
  */
 declare module 'tty' {
     import * as net from 'node:net';

node/url.d.ts

@@ -5,9 +5,10 @@
  * ```js
  * import url from 'url';
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/url.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/url.js)
  */
 declare module 'url' {
+    import { Blob } from 'node:buffer';
     import { ClientRequestArgs } from 'node:http';
     import { ParsedUrlQuery, ParsedUrlQueryInput } from 'node:querystring';
     // Input to `url.format`
@@ -263,7 +264,7 @@ declare module 'url' {
      * import { urlToHttpOptions } from 'url';
      * const myURL = new URL('https://a:b@測試?abc#foo');
      *
-     * console.log(urlToHttpOptions(myUrl));
+     * console.log(urlToHttpOptions(myURL));
      *
      * {
      *   protocol: 'https:',
@@ -301,6 +302,40 @@ declare module 'url' {
      * @since v7.0.0, v6.13.0
      */
     class URL {
+        /**
+         * Creates a `'blob:nodedata:...'` URL string that represents the given `Blob` object and can be used to retrieve the `Blob` later.
+         *
+         * ```js
+         * const {
+         *   Blob,
+         *   resolveObjectURL,
+         * } = require('buffer');
+         *
+         * const blob = new Blob(['hello']);
+         * const id = URL.createObjectURL(blob);
+         *
+         * // later...
+         *
+         * const otherBlob = resolveObjectURL(id);
+         * console.log(otherBlob.size);
+         * ```
+         *
+         * The data stored by the registered `Blob` will be retained in memory until`URL.revokeObjectURL()` is called to remove it.
+         *
+         * `Blob` objects are registered within the current thread. If using Worker
+         * Threads, `Blob` objects registered within one Worker will not be available
+         * to other workers or the main thread.
+         * @since v16.7.0
+         * @experimental
+         */
+        static createObjectURL(blob: Blob): string;
+        /**
+         * Removes the stored `Blob` identified by the given ID.
+         * @since v16.7.0
+         * @experimental
+         * @param id A `'blob:nodedata:...` URL string returned by a prior call to `URL.createObjectURL()`.
+         */
+        static revokeObjectURL(objectUrl: string): void;
         constructor(input: string, base?: string | URL);
         /**
          * Gets and sets the fragment portion of the URL.

node/util.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const util = require('util');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/util.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/util.js)
  */
 declare module 'util' {
     import * as types from 'node:util/types';
@@ -1538,12 +1538,12 @@ declare module 'util/types' {
      */
     function isWeakSet(object: unknown): object is WeakSet<object>;
     /**
-     * Returns `true` if `value` is a `<KeyObject>`, `false` otherwise.
+     * Returns `true` if `value` is a `KeyObject`, `false` otherwise.
      * @since v16.2.0
      */
     function isKeyObject(object: unknown): object is KeyObject;
     /**
-     * Returns `true` if `value` is a `<CryptoKey>`, `false` otherwise.
+     * Returns `true` if `value` is a `CryptoKey`, `false` otherwise.
      * @since v16.2.0
      */
     function isCryptoKey(object: unknown): object is webcrypto.CryptoKey;

node/v8.d.ts

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

node/vm.d.ts

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

node/wasi.d.ts

@@ -63,7 +63,7 @@
  * The `--experimental-wasi-unstable-preview1` CLI argument is needed for this
  * example to run.
  * @experimental
- * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/wasi.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/wasi.js)
  */
 declare module 'wasi' {
     interface WASIOptions {

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/v16.6.0/lib/worker_threads.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.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/v16.6.0/lib/zlib.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/zlib.js)
  */
 declare module 'zlib' {
     import * as stream from 'node:stream';

node/base.d.ts

@@ -1,19 +0,0 @@
-// NOTE: These definitions support NodeJS and TypeScript 3.7.
-
-// NOTE: TypeScript version-specific augmentations can be found in the following paths:
-//          - ~/base.d.ts         - Shared definitions common to all TypeScript versions
-//          - ~/index.d.ts        - Definitions specific to TypeScript 2.1
-//          - ~/ts3.7/base.d.ts   - Definitions specific to TypeScript 3.7
-//          - ~/ts3.7/index.d.ts  - Definitions specific to TypeScript 3.7 with assert pulled in
-
-// Reference required types from the default lib:
-/// <reference lib="es2020" />
-/// <reference lib="esnext.asynciterable" />
-/// <reference lib="esnext.intl" />
-/// <reference lib="esnext.bigint" />
-
-// Base definitions for all NodeJS modules that are not specific to any version of TypeScript:
-/// <reference path="ts3.6/base.d.ts" />
-
-// TypeScript 3.7-specific augmentations:
-/// <reference path="assert.d.ts" />

node/ts3.6/assert.d.ts

@@ -1,103 +0,0 @@
-declare module 'assert' {
-    /** An alias of `assert.ok()`. */
-    function assert(value: unknown, message?: string | Error): void;
-    namespace assert {
-        class AssertionError extends Error {
-            actual: unknown;
-            expected: unknown;
-            operator: string;
-            generatedMessage: boolean;
-            code: 'ERR_ASSERTION';
-
-            constructor(options?: {
-                /** If provided, the error message is set to this value. */
-                message?: string;
-                /** The `actual` property on the error instance. */
-                actual?: unknown;
-                /** The `expected` property on the error instance. */
-                expected?: unknown;
-                /** The `operator` property on the error instance. */
-                operator?: string;
-                /** If provided, the generated stack trace omits frames before this function. */
-                // tslint:disable-next-line:ban-types
-                stackStartFn?: Function;
-            });
-        }
-
-        class CallTracker {
-            calls(exact?: number): () => void;
-            calls<Func extends (...args: any[]) => any>(fn?: Func, exact?: number): Func;
-            report(): CallTrackerReportInformation[];
-            verify(): void;
-        }
-        interface CallTrackerReportInformation {
-            message: string;
-            /** The actual number of times the function was called. */
-            actual: number;
-            /** The number of times the function was expected to be called. */
-            expected: number;
-            /** The name of the function that is wrapped. */
-            operator: string;
-            /** A stack trace of the function. */
-            stack: object;
-        }
-
-        type AssertPredicate = RegExp | (new () => object) | ((thrown: unknown) => boolean) | object | Error;
-
-        function fail(message?: string | Error): never;
-        /** @deprecated since v10.0.0 - use fail([message]) or other assert functions instead. */
-        function fail(
-            actual: unknown,
-            expected: unknown,
-            message?: string | Error,
-            operator?: string,
-            // tslint:disable-next-line:ban-types
-            stackStartFn?: Function,
-        ): never;
-        function ok(value: unknown, message?: string | Error): void;
-        /** @deprecated since v9.9.0 - use strictEqual() instead. */
-        function equal(actual: unknown, expected: unknown, message?: string | Error): void;
-        /** @deprecated since v9.9.0 - use notStrictEqual() instead. */
-        function notEqual(actual: unknown, expected: unknown, message?: string | Error): void;
-        /** @deprecated since v9.9.0 - use deepStrictEqual() instead. */
-        function deepEqual(actual: unknown, expected: unknown, message?: string | Error): void;
-        /** @deprecated since v9.9.0 - use notDeepStrictEqual() instead. */
-        function notDeepEqual(actual: unknown, expected: unknown, message?: string | Error): void;
-        function strictEqual(actual: unknown, expected: unknown, message?: string | Error): void;
-        function notStrictEqual(actual: unknown, expected: unknown, message?: string | Error): void;
-        function deepStrictEqual(actual: unknown, expected: unknown, message?: string | Error): void;
-        function notDeepStrictEqual(actual: unknown, expected: unknown, message?: string | Error): void;
-
-        function throws(block: () => unknown, message?: string | Error): void;
-        function throws(block: () => unknown, error: AssertPredicate, message?: string | Error): void;
-        function doesNotThrow(block: () => unknown, message?: string | Error): void;
-        function doesNotThrow(block: () => unknown, error: AssertPredicate, message?: string | Error): void;
-
-        function ifError(value: unknown): void;
-
-        function rejects(block: (() => Promise<unknown>) | Promise<unknown>, message?: string | Error): Promise<void>;
-        function rejects(
-            block: (() => Promise<unknown>) | Promise<unknown>,
-            error: AssertPredicate,
-            message?: string | Error,
-        ): Promise<void>;
-        function doesNotReject(block: (() => Promise<unknown>) | Promise<unknown>, message?: string | Error): Promise<void>;
-        function doesNotReject(
-            block: (() => Promise<unknown>) | Promise<unknown>,
-            error: AssertPredicate,
-            message?: string | Error,
-        ): Promise<void>;
-
-        function match(value: string, regExp: RegExp, message?: string | Error): void;
-        function doesNotMatch(value: string, regExp: RegExp, message?: string | Error): void;
-
-        const strict: typeof assert;
-    }
-
-    export = assert;
-}
-
-declare module 'node:assert' {
-    import assert = require('assert');
-    export = assert;
-}

node/ts3.6/base.d.ts

@@ -1,68 +0,0 @@
-// NOTE: These definitions support NodeJS and TypeScript 3.6 and earlier.
-
-// NOTE: TypeScript version-specific augmentations can be found in the following paths:
-//          - ~/base.d.ts         - Shared definitions common to all TypeScript versions
-//          - ~/index.d.ts        - Definitions specific to TypeScript 3.7 and above
-//          - ~/ts3.6/base.d.ts   - Definitions specific to TypeScript 3.6 and earlier
-//          - ~/ts3.6/index.d.ts  - Definitions specific to TypeScript 3.6 and earlier with assert pulled in
-
-// Reference required types from the default lib:
-/// <reference lib="es2020" />
-/// <reference lib="esnext.asynciterable" />
-/// <reference lib="esnext.intl" />
-/// <reference lib="esnext.bigint" />
-
-// Base definitions for all NodeJS modules that are not specific to any version of TypeScript:
-/// <reference path="../assert/strict.d.ts" />
-/// <reference path="../globals.d.ts" />
-/// <reference path="../async_hooks.d.ts" />
-/// <reference path="../buffer.d.ts" />
-/// <reference path="../child_process.d.ts" />
-/// <reference path="../cluster.d.ts" />
-/// <reference path="../console.d.ts" />
-/// <reference path="../constants.d.ts" />
-/// <reference path="../crypto.d.ts" />
-/// <reference path="../dgram.d.ts" />
-/// <reference path="../diagnostics_channel.d.ts" />
-/// <reference path="../dns.d.ts" />
-/// <reference path="../dns/promises.d.ts" />
-/// <reference path="../dns/promises.d.ts" />
-/// <reference path="../domain.d.ts" />
-/// <reference path="../events.d.ts" />
-/// <reference path="../fs.d.ts" />
-/// <reference path="../fs/promises.d.ts" />
-/// <reference path="../http.d.ts" />
-/// <reference path="../http2.d.ts" />
-/// <reference path="../https.d.ts" />
-/// <reference path="../inspector.d.ts" />
-/// <reference path="../module.d.ts" />
-/// <reference path="../net.d.ts" />
-/// <reference path="../os.d.ts" />
-/// <reference path="../path.d.ts" />
-/// <reference path="../perf_hooks.d.ts" />
-/// <reference path="../process.d.ts" />
-/// <reference path="../punycode.d.ts" />
-/// <reference path="../querystring.d.ts" />
-/// <reference path="../readline.d.ts" />
-/// <reference path="../repl.d.ts" />
-/// <reference path="../stream.d.ts" />
-/// <reference path="../stream/promises.d.ts" />
-/// <reference path="../stream/web.d.ts" />
-/// <reference path="../string_decoder.d.ts" />
-/// <reference path="../timers.d.ts" />
-/// <reference path="../timers/promises.d.ts" />
-/// <reference path="../tls.d.ts" />
-/// <reference path="../trace_events.d.ts" />
-/// <reference path="../tty.d.ts" />
-/// <reference path="../url.d.ts" />
-/// <reference path="../util.d.ts" />
-/// <reference path="../v8.d.ts" />
-/// <reference path="../vm.d.ts" />
-/// <reference path="../worker_threads.d.ts" />
-/// <reference path="../zlib.d.ts" />
-
-// TypeScript 3.6-specific augmentations:
-/// <reference path="../globals.global.d.ts" />
-
-// TypeScript 3.6-specific augmentations:
-/// <reference path="../wasi.d.ts" />

node/ts3.6/index.d.ts

@@ -1,7 +0,0 @@
-// NOTE: These definitions support NodeJS and TypeScript 3.6.
-// This is required to enable typing assert in ts3.7 without causing errors
-// Typically type modifications should be made in base.d.ts instead of here
-
-/// <reference path="base.d.ts" />
-
-/// <reference path="assert.d.ts" />