@types/node 16.4.12 → 16.6.1

node/process.d.ts

@@ -244,7 +244,9 @@ declare module 'process' {
                  * For example, to copy `process.stdin` to `process.stdout`:
                  *
                  * ```js
-                 * process.stdin.pipe(process.stdout);
+                 * import { stdin, stdout } from 'process';
+                 *
+                 * stdin.pipe(stdout);
                  * ```
                  *
                  * `process.stdout` differs from other Node.js streams in important ways. See `note on process I/O` for more information.
@@ -289,8 +291,10 @@ declare module 'process' {
                  * For example, assuming the following script for `process-args.js`:
                  *
                  * ```js
+                 * import { argv } from 'process';
+                 *
                  * // print process.argv
-                 * process.argv.forEach((val, index) => {
+                 * argv.forEach((val, index) => {
                  *   console.log(`${index}: ${val}`);
                  * });
                  * ```
@@ -379,10 +383,12 @@ declare module 'process' {
                  * the specified `directory` does not exist).
                  *
                  * ```js
-                 * console.log(`Starting directory: ${process.cwd()}`);
+                 * import { chdir, cwd } from 'process';
+                 *
+                 * console.log(`Starting directory: ${cwd()}`);
                  * try {
-                 *   process.chdir('/tmp');
-                 *   console.log(`New directory: ${process.cwd()}`);
+                 *   chdir('/tmp');
+                 *   console.log(`New directory: ${cwd()}`);
                  * } catch (err) {
                  *   console.error(`chdir: ${err}`);
                  * }
@@ -397,7 +403,9 @@ declare module 'process' {
                  * process.
                  *
                  * ```js
-                 * console.log(`Current directory: ${process.cwd()}`);
+                 * import { cwd } from 'process';
+                 *
+                 * console.log(`Current directory: ${cwd()}`);
                  * ```
                  * @since v0.1.8
                  */
@@ -406,6 +414,8 @@ declare module 'process' {
                  * The port used by the Node.js debugger when enabled.
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * process.debugPort = 5858;
                  * ```
                  * @since v0.7.2
@@ -416,8 +426,10 @@ declare module 'process' {
                  * specific process warnings. These can be listened for by adding a handler to the `'warning'` event.
                  *
                  * ```js
+                 * import { emitWarning } from 'process';
+                 *
                  * // Emit a warning with a code and additional detail.
-                 * process.emitWarning('Something happened!', {
+                 * emitWarning('Something happened!', {
                  *   code: 'MY_WARNING',
                  *   detail: 'This is some additional information'
                  * });
@@ -429,6 +441,8 @@ declare module 'process' {
                  * In this example, an `Error` object is generated internally by`process.emitWarning()` and passed through to the `'warning'` handler.
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * process.on('warning', (warning) => {
                  *   console.warn(warning.name);    // 'Warning'
                  *   console.warn(warning.message); // 'Something happened!'
@@ -479,8 +493,10 @@ declare module 'process' {
                  * While the following will:
                  *
                  * ```js
-                 * process.env.foo = 'bar';
-                 * console.log(process.env.foo);
+                 * import { env } from 'process';
+                 *
+                 * env.foo = 'bar';
+                 * console.log(env.foo);
                  * ```
                  *
                  * Assigning a property on `process.env` will implicitly convert the value
@@ -488,28 +504,34 @@ declare module 'process' {
                  * throw an error when the value is not a string, number, or boolean.
                  *
                  * ```js
-                 * process.env.test = null;
-                 * console.log(process.env.test);
+                 * import { env } from 'process';
+                 *
+                 * env.test = null;
+                 * console.log(env.test);
                  * // => 'null'
-                 * process.env.test = undefined;
-                 * console.log(process.env.test);
+                 * env.test = undefined;
+                 * console.log(env.test);
                  * // => 'undefined'
                  * ```
                  *
                  * Use `delete` to delete a property from `process.env`.
                  *
                  * ```js
-                 * process.env.TEST = 1;
-                 * delete process.env.TEST;
-                 * console.log(process.env.TEST);
+                 * import { env } from 'process';
+                 *
+                 * env.TEST = 1;
+                 * delete env.TEST;
+                 * console.log(env.TEST);
                  * // => undefined
                  * ```
                  *
                  * On Windows operating systems, environment variables are case-insensitive.
                  *
                  * ```js
-                 * process.env.TEST = 1;
-                 * console.log(process.env.test);
+                 * import { env } from 'process';
+                 *
+                 * env.TEST = 1;
+                 * console.log(env.test);
                  * // => 1
                  * ```
                  *
@@ -532,7 +554,9 @@ declare module 'process' {
                  * To exit with a 'failure' code:
                  *
                  * ```js
-                 * process.exit(1);
+                 * import { exit } from 'process';
+                 *
+                 * exit(1);
                  * ```
                  *
                  * The shell that executed Node.js should see the exit code as `1`.
@@ -549,10 +573,12 @@ declare module 'process' {
                  * truncated and lost:
                  *
                  * ```js
+                 * import { exit } from 'process';
+                 *
                  * // This is an example of what *not* to do:
                  * if (someConditionNotMet()) {
                  *   printUsageToStdout();
-                 *   process.exit(1);
+                 *   exit(1);
                  * }
                  * ```
                  *
@@ -564,6 +590,8 @@ declare module 'process' {
                  * scheduling any additional work for the event loop:
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * // How to properly set the exit code while letting
                  * // the process exit gracefully.
                  * if (someConditionNotMet()) {
@@ -597,6 +625,8 @@ declare module 'process' {
                  * process. (See [`getgid(2)`](http://man7.org/linux/man-pages/man2/getgid.2.html).)
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.getgid) {
                  *   console.log(`Current gid: ${process.getgid()}`);
                  * }
@@ -614,6 +644,8 @@ declare module 'process' {
                  * associated numeric ID.
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.getgid && process.setgid) {
                  *   console.log(`Current gid: ${process.getgid()}`);
                  *   try {
@@ -637,6 +669,8 @@ declare module 'process' {
                  * (See [`getuid(2)`](http://man7.org/linux/man-pages/man2/getuid.2.html).)
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.getuid) {
                  *   console.log(`Current uid: ${process.getuid()}`);
                  * }
@@ -654,6 +688,8 @@ declare module 'process' {
                  * numeric ID.
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.getuid && process.setuid) {
                  *   console.log(`Current uid: ${process.getuid()}`);
                  *   try {
@@ -676,6 +712,8 @@ declare module 'process' {
                  * the process. (See [`geteuid(2)`](http://man7.org/linux/man-pages/man2/geteuid.2.html).)
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.geteuid) {
                  *   console.log(`Current uid: ${process.geteuid()}`);
                  * }
@@ -693,6 +731,8 @@ declare module 'process' {
                  * associated numeric ID.
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.geteuid && process.seteuid) {
                  *   console.log(`Current uid: ${process.geteuid()}`);
                  *   try {
@@ -716,6 +756,8 @@ declare module 'process' {
                  * of the Node.js process. (See [`getegid(2)`](http://man7.org/linux/man-pages/man2/getegid.2.html).)
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.getegid) {
                  *   console.log(`Current gid: ${process.getegid()}`);
                  * }
@@ -733,6 +775,8 @@ declare module 'process' {
                  * the associated a numeric ID.
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.getegid && process.setegid) {
                  *   console.log(`Current gid: ${process.getegid()}`);
                  *   try {
@@ -757,6 +801,8 @@ declare module 'process' {
                  * Node.js ensures it always is.
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.getgroups) {
                  *   console.log(process.getgroups()); // [ 16, 21, 297 ]
                  * }
@@ -775,6 +821,8 @@ declare module 'process' {
                  * The `groups` array can contain numeric group IDs, group names, or both.
                  *
                  * ```js
+                 * import process from 'process';
+                 *
                  * if (process.getgroups && process.setgroups) {
                  *   try {
                  *     process.setgroups([501]);
@@ -819,7 +867,9 @@ declare module 'process' {
                  * The `process.version` property contains the Node.js version string.
                  *
                  * ```js
-                 * console.log(`Version: ${process.version}`);
+                 * import { version } from 'process';
+                 *
+                 * console.log(`Version: ${version}`);
                  * // Version: v14.8.0
                  * ```
                  *
@@ -834,7 +884,9 @@ declare module 'process' {
                  * to load modules that were compiled against a different module ABI version.
                  *
                  * ```js
-                 * console.log(process.versions);
+                 * import { versions } from 'process';
+                 *
+                 * console.log(versions);
                  * ```
                  *
                  * Will generate an object similar to:
@@ -919,6 +971,8 @@ declare module 'process' {
                  * other than kill the target process.
                  *
                  * ```js
+                 * import process, { kill } from 'process';
+                 *
                  * process.on('SIGHUP', () => {
                  *   console.log('Got SIGHUP signal.');
                  * });
@@ -928,7 +982,7 @@ declare module 'process' {
                  *   process.exit(0);
                  * }, 100);
                  *
-                 * process.kill(process.pid, 'SIGHUP');
+                 * kill(process.pid, 'SIGHUP');
                  * ```
                  *
                  * When `SIGUSR1` is received by a Node.js process, Node.js will start the
@@ -942,7 +996,9 @@ declare module 'process' {
                  * The `process.pid` property returns the PID of the process.
                  *
                  * ```js
-                 * console.log(`This process is pid ${process.pid}`);
+                 * import { pid } from 'process';
+                 *
+                 * console.log(`This process is pid ${pid}`);
                  * ```
                  * @since v0.1.15
                  */
@@ -952,7 +1008,9 @@ declare module 'process' {
                  * current process.
                  *
                  * ```js
-                 * console.log(`The parent process is pid ${process.ppid}`);
+                 * import { ppid } from 'process';
+                 *
+                 * console.log(`The parent process is pid ${ppid}`);
                  * ```
                  * @since v9.2.0, v8.10.0, v6.13.0
                  */
@@ -980,7 +1038,9 @@ declare module 'process' {
                  * Possible values are: `'arm'`, `'arm64'`, `'ia32'`, `'mips'`,`'mipsel'`, `'ppc'`,`'ppc64'`, `'s390'`, `'s390x'`, `'x32'`, and `'x64'`.
                  *
                  * ```js
-                 * console.log(`This processor architecture is ${process.arch}`);
+                 * import { arch } from 'process';
+                 *
+                 * console.log(`This processor architecture is ${arch}`);
                  * ```
                  * @since v0.5.0
                  */
@@ -1000,7 +1060,9 @@ declare module 'process' {
                  * * `'win32'`
                  *
                  * ```js
-                 * console.log(`This platform is ${process.platform}`);
+                 * import { platform } from 'process';
+                 *
+                 * console.log(`This platform is ${platform}`);
                  * ```
                  *
                  * The value `'android'` may also be returned if the Node.js is built on the
@@ -1032,14 +1094,16 @@ declare module 'process' {
                  * argument to the function, to get a diff reading.
                  *
                  * ```js
-                 * const startUsage = process.cpuUsage();
+                 * import { cpuUsage } from 'process';
+                 *
+                 * const startUsage = cpuUsage();
                  * // { user: 38579, system: 6986 }
                  *
                  * // spin the CPU for 500 milliseconds
                  * const now = Date.now();
                  * while (Date.now() - now < 500);
                  *
-                 * console.log(process.cpuUsage(startUsage));
+                 * console.log(cpuUsage(startUsage));
                  * // { user: 514883, system: 11226 }
                  * ```
                  * @since v6.1.0
@@ -1054,8 +1118,10 @@ declare module 'process' {
                  * See the [Event Loop](https://nodejs.org/en/docs/guides/event-loop-timers-and-nexttick/#process-nexttick) guide for more background.
                  *
                  * ```js
+                 * import { nextTick } from 'process';
+                 *
                  * console.log('start');
-                 * process.nextTick(() => {
+                 * nextTick(() => {
                  *   console.log('nextTick callback');
                  * });
                  * console.log('scheduled');
@@ -1070,10 +1136,12 @@ declare module 'process' {
                  * I/O has occurred:
                  *
                  * ```js
+                 * import { nextTick } from 'process';
+                 *
                  * function MyThing(options) {
                  *   this.setupOptions(options);
                  *
-                 *   process.nextTick(() => {
+                 *   nextTick(() => {
                  *     this.startDoingStuff();
                  *   });
                  * }
@@ -1116,9 +1184,11 @@ declare module 'process' {
                  * The following approach is much better:
                  *
                  * ```js
+                 * import { nextTick } from 'process';
+                 *
                  * function definitelyAsync(arg, cb) {
                  *   if (arg) {
-                 *     process.nextTick(cb);
+                 *     nextTick(cb);
                  *     return;
                  *   }
                  *
@@ -1246,7 +1316,9 @@ declare module 'process' {
                  * dashes:
                  *
                  * ```js
-                 * process.allowedNodeEnvironmentFlags.forEach((flag) => {
+                 * import { allowedNodeEnvironmentFlags } from 'process';
+                 *
+                 * allowedNodeEnvironmentFlags.forEach((flag) => {
                  *   // -r
                  *   // --inspect-brk
                  *   // --abort_on_uncaught_exception
@@ -1270,7 +1342,9 @@ declare module 'process' {
                 report?: ProcessReport | undefined;
                 /**
                  * ```js
-                 * console.log(process.resourceUsage());
+                 * import { resourceUsage } from 'process';
+                 *
+                 * console.log(resourceUsage());
                  * /*
                  *   Will output:
                  *   {

node/punycode.d.ts

@@ -1,6 +1,5 @@
 /**
- * **The version of the punycode module bundled in Node.js is being deprecated**.
- * In a future major version of Node.js this module will be removed. Users
+ * **The version of the punycode module bundled in Node.js is being deprecated.**In a future major version of Node.js this module will be removed. Users
  * currently depending on the `punycode` module should switch to using the
  * userland-provided [Punycode.js](https://github.com/bestiejs/punycode.js) module instead. For punycode-based URL
  * encoding, see `url.domainToASCII` or, more generally, the `WHATWG URL API`.
@@ -25,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.4.2/lib/punycode.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.6.0/lib/punycode.js)
  */
 declare module 'punycode' {
     /**

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';
@@ -452,7 +452,7 @@ declare module 'tls' {
          * SecureContext.) If SNICallback wasn't provided the default callback
          * with high-level API will be used (see below).
          */
-        SNICallback?: ((servername: string, cb: (err: Error | null, ctx: SecureContext) => void) => void) | undefined;
+        SNICallback?: ((servername: string, cb: (err: Error | null, ctx?: SecureContext) => void) => void) | undefined;
         /**
          * If true the server will reject any connection which is not
          * authorized with the list of supplied CAs. This option only has an

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];