@types/node 16.4.11 → 16.6.0

node/querystring.d.ts

@@ -9,7 +9,7 @@
  * The `querystring` API is considered Legacy. While it is still maintained,
  * new code should use the `<URLSearchParams>` API instead.
  * @deprecated Legacy
- * @see [source](https://github.com/nodejs/node/blob/v16.4.2/lib/querystring.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.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.4.2/lib/readline.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.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.4.2/lib/repl.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/repl.js)
  */
 declare module 'repl' {
     import { Interface, Completer, AsyncCompleter } from 'node:readline';

node/stream/web.d.ts

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

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.4.2/lib/string_decoder.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/string_decoder.js)
  */
 declare module 'string_decoder' {
     class StringDecoder {

node/timers/promises.d.ts

@@ -9,14 +9,6 @@
  *   setInterval,
  * } from 'timers/promises';
  * ```
- *
- * ```js
- * const {
- *   setTimeout,
- *   setImmediate,
- *   setInterval,
- * } = require('timers/promises');
- * ```
  * @since v15.0.0
  */
 declare module 'timers/promises' {
@@ -31,16 +23,6 @@ declare module 'timers/promises' {
      *
      * console.log(res);  // Prints 'result'
      * ```
-     *
-     * ```js
-     * const {
-     *   setTimeout,
-     * } = require('timers/promises');
-     *
-     * setTimeout(100, 'result').then((res) => {
-     *   console.log(res);  // Prints 'result'
-     * });
-     * ```
      * @since v15.0.0
      * @param [delay=1] The number of milliseconds to wait before fulfilling the promise.
      * @param value A value with which the promise is fulfilled.
@@ -56,16 +38,6 @@ declare module 'timers/promises' {
      *
      * console.log(res);  // Prints 'result'
      * ```
-     *
-     * ```js
-     * const {
-     *   setImmediate,
-     * } = require('timers/promises');
-     *
-     * setImmediate('result').then((res) => {
-     *   console.log(res);  // Prints 'result'
-     * });
-     * ```
      * @since v15.0.0
      * @param value A value with which the promise is fulfilled.
      */
@@ -87,23 +59,6 @@ declare module 'timers/promises' {
      * }
      * console.log(Date.now());
      * ```
-     *
-     * ```js
-     * const {
-     *   setInterval,
-     * } = require('timers/promises');
-     * const interval = 100;
-     *
-     * (async function() {
-     *   for await (const startTime of setInterval(interval, Date.now())) {
-     *     const now = Date.now();
-     *     console.log(now);
-     *     if ((now - startTime) > 1000)
-     *       break;
-     *   }
-     *   console.log(Date.now());
-     * })();
-     * ```
      * @since v15.9.0
      */
     function setInterval<T = void>(delay?: number, value?: T, options?: TimerOptions): AsyncIterable<T>;

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

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.4.2/lib/trace_events.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/trace_events.js)
  */
 declare module 'trace_events' {
     /**

node/ts3.6/base.d.ts

@@ -7,7 +7,7 @@
 //          - ~/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="es2018" />
+/// <reference lib="es2020" />
 /// <reference lib="esnext.asynciterable" />
 /// <reference lib="esnext.intl" />
 /// <reference lib="esnext.bigint" />
@@ -47,6 +47,7 @@
 /// <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" />

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.4.2/lib/tty.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/tty.js)
  */
 declare module 'tty' {
     import * as net from 'node:net';
@@ -176,9 +176,9 @@ declare module 'tty' {
         hasColors(env?: object): boolean;
         hasColors(count: number, env?: object): boolean;
         /**
-         * `writeStream.getWindowSize()` returns the size of the `TTY` corresponding to this `WriteStream`. The array is of the type`[numColumns, numRows]` where `numColumns` and `numRows` represent
-         * the number
-         * of columns and rows in the corresponding `TTY`.
+         * `writeStream.getWindowSize()` returns the size of the TTY
+         * corresponding to this `WriteStream`. The array is of the type`[numColumns, numRows]` where `numColumns` and `numRows` represent the number
+         * of columns and rows in the corresponding TTY.
          * @since v0.7.7
          */
         getWindowSize(): [number, number];

node/url.d.ts

@@ -5,11 +5,7 @@
  * ```js
  * import url from 'url';
  * ```
- *
- * ```js
- * const url = require('url');
- * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.4.2/lib/url.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/url.js)
  */
 declare module 'url' {
     import { ClientRequestArgs } from 'node:http';
@@ -191,17 +187,6 @@ declare module 'url' {
      * console.log(url.domainToASCII('xn--iñvalid.com'));
      * // Prints an empty string
      * ```
-     *
-     * ```js
-     * const url = require('url');
-     *
-     * console.log(url.domainToASCII('español.com'));
-     * // Prints xn--espaol-zwa.com
-     * console.log(url.domainToASCII('中文.com'));
-     * // Prints xn--fiq228c.com
-     * console.log(url.domainToASCII('xn--iñvalid.com'));
-     * // Prints an empty string
-     * ```
      * @since v7.4.0, v6.13.0
      */
     function domainToASCII(domain: string): string;
@@ -223,17 +208,6 @@ declare module 'url' {
      * console.log(url.domainToUnicode('xn--iñvalid.com'));
      * // Prints an empty string
      * ```
-     *
-     * ```js
-     * const url = require('url');
-     *
-     * console.log(url.domainToUnicode('xn--espaol-zwa.com'));
-     * // Prints español.com
-     * console.log(url.domainToUnicode('xn--fiq228c.com'));
-     * // Prints 中文.com
-     * console.log(url.domainToUnicode('xn--iñvalid.com'));
-     * // Prints an empty string
-     * ```
      * @since v7.4.0, v6.13.0
      */
     function domainToUnicode(domain: string): string;
@@ -258,21 +232,6 @@ declare module 'url' {
      * new URL('file:///hello world').pathname;   // Incorrect: /hello%20world
      * fileURLToPath('file:///hello world');      // Correct:   /hello world (POSIX)
      * ```
-     *
-     * ```js
-     * const { fileURLToPath } = require('url');
-     * new URL('file:///C:/path/').pathname;      // Incorrect: /C:/path/
-     * fileURLToPath('file:///C:/path/');         // Correct:   C:\path\ (Windows)
-     *
-     * new URL('file://nas/foo.txt').pathname;    // Incorrect: /foo.txt
-     * fileURLToPath('file://nas/foo.txt');       // Correct:   \\nas\foo.txt (Windows)
-     *
-     * new URL('file:///你好.txt').pathname;      // Incorrect: /%E4%BD%A0%E5%A5%BD.txt
-     * fileURLToPath('file:///你好.txt');         // Correct:   /你好.txt (POSIX)
-     *
-     * new URL('file:///hello world').pathname;   // Incorrect: /hello%20world
-     * fileURLToPath('file:///hello world');      // Correct:   /hello world (POSIX)
-     * ```
      * @since v10.12.0
      * @param url The file URL string or URL object to convert to a path.
      * @return The fully-resolved platform-specific Node.js file path.
@@ -291,20 +250,6 @@ declare module 'url' {
      * new URL('/some/path%.c', 'file:');    // Incorrect: file:///some/path%.c
      * pathToFileURL('/some/path%.c');       // Correct:   file:///some/path%25.c (POSIX)
      * ```
-     *
-     * ```js
-     * const { pathToFileURL } = require('url');
-     * new URL(__filename);                  // Incorrect: throws (POSIX)
-     * new URL(__filename);                  // Incorrect: C:\... (Windows)
-     * pathToFileURL(__filename);            // Correct:   file:///... (POSIX)
-     * pathToFileURL(__filename);            // Correct:   file:///C:/... (Windows)
-     *
-     * new URL('/foo#1', 'file:');           // Incorrect: file:///foo#1
-     * pathToFileURL('/foo#1');              // Correct:   file:///foo%231 (POSIX)
-     *
-     * new URL('/some/path%.c', 'file:');    // Incorrect: file:///some/path%.c
-     * pathToFileURL('/some/path%.c');       // Correct:   file:///some/path%25.c (POSIX)
-     * ```
      * @since v10.12.0
      * @param path The path to convert to a File URL.
      * @return The file URL object.
@@ -332,25 +277,6 @@ declare module 'url' {
      * }
      *
      * ```
-     *
-     * ```js
-     * const { urlToHttpOptions } = require('url');
-     * const myURL = new URL('https://a:b@測試?abc#foo');
-     *
-     * console.log(urlToHttpOptions(myUrl));
-     *
-     * {
-     *   protocol: 'https:',
-     *   hostname: 'xn--g6w251d',
-     *   hash: '#foo',
-     *   search: '?abc',
-     *   pathname: '/',
-     *   path: '/?abc',
-     *   href: 'https://a:b@xn--g6w251d/?abc#foo',
-     *   auth: 'a:b'
-     * }
-     *
-     * ```
      * @since v15.7.0
      * @param url The `WHATWG URL` object to convert to an options object.
      * @return Options object

node/util.d.ts

@@ -6,7 +6,7 @@
  * ```js
  * const util = require('util');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.4.2/lib/util.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/util.js)
  */
 declare module 'util' {
     import * as types from 'node:util/types';

node/v8.d.ts

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

node/vm.d.ts

@@ -1,7 +1,7 @@
 /**
  * The `vm` module enables compiling and running code within V8 Virtual
  * Machine contexts. **The `vm` module is not a security mechanism. Do**
- * **not use it to run untrusted code**.
+ * **not use it to run untrusted code.**
  *
  * JavaScript code can be compiled and run immediately or
  * compiled, saved, and run later.
@@ -32,7 +32,7 @@
  *
  * console.log(x); // 1; y is not defined.
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.4.2/lib/vm.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/vm.js)
  */
 declare module 'vm' {
     interface Context extends NodeJS.Dict<any> {}

node/wasi.d.ts

@@ -5,10 +5,11 @@
  * ```js
  * import fs from 'fs';
  * import { WASI } from 'wasi';
+ * import { argv, env } from 'process';
  *
  * const wasi = new WASI({
- *   args: process.argv,
- *   env: process.env,
+ *   args: argv,
+ *   env,
  *   preopens: {
  *     '/sandbox': '/some/real/path/that/wasm/can/access'
  *   }
@@ -21,27 +22,6 @@
  * wasi.start(instance);
  * ```
  *
- * ```js
- * 'use strict';
- * const fs = require('fs');
- * const { WASI } = require('wasi');
- * const wasi = new WASI({
- *   args: process.argv,
- *   env: process.env,
- *   preopens: {
- *     '/sandbox': '/some/real/path/that/wasm/can/access'
- *   }
- * });
- * const importObject = { wasi_snapshot_preview1: wasi.wasiImport };
- *
- * (async () => {
- *   const wasm = await WebAssembly.compile(fs.readFileSync('./demo.wasm'));
- *   const instance = await WebAssembly.instantiate(wasm, importObject);
- *
- *   wasi.start(instance);
- * })();
- * ```
- *
  * To run the above example, create a new WebAssembly text format file named`demo.wat`:
  *
  * ```text
@@ -83,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.4.2/lib/wasi.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.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.4.2/lib/worker_threads.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.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.4.2/lib/zlib.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/zlib.js)
  */
 declare module 'zlib' {
     import * as stream from 'node:stream';