@types/node 15.6.2 → 15.12.2

node/fs.d.ts

@@ -276,9 +276,7 @@ declare module 'fs' {
     /**
      * Asynchronous rename(2) - Change the name or location of a file or directory.
      * @param oldPath A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * @param newPath A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function rename(oldPath: PathLike, newPath: PathLike, callback: NoParamCallback): void;
 
@@ -297,9 +295,7 @@ declare module 'fs' {
     /**
      * Synchronous rename(2) - Change the name or location of a file or directory.
      * @param oldPath A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * @param newPath A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function renameSync(oldPath: PathLike, newPath: PathLike): void;
 
@@ -313,7 +309,6 @@ declare module 'fs' {
     /**
      * Asynchronous truncate(2) - Truncate a file to a specified length.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function truncate(path: PathLike, callback: NoParamCallback): void;
 
@@ -1242,7 +1237,7 @@ declare module 'fs' {
      * Asynchronous close(2) - close a file descriptor.
      * @param fd A file descriptor.
      */
-    export function close(fd: number, callback: NoParamCallback): void;
+    export function close(fd: number, callback?: NoParamCallback): void;
 
     // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
     export namespace close {
@@ -1487,6 +1482,8 @@ declare module 'fs' {
      */
     export function writeSync(fd: number, string: string, position?: number | null, encoding?: BufferEncoding | null): number;
 
+    export type ReadPosition = number | bigint;
+
     /**
      * Asynchronously reads data from the file referenced by the supplied file descriptor.
      * @param fd A file descriptor.
@@ -1500,7 +1497,7 @@ declare module 'fs' {
         buffer: TBuffer,
         offset: number,
         length: number,
-        position: number | null,
+        position: ReadPosition | null,
         callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: TBuffer) => void,
     ): void;
 
@@ -1534,7 +1531,7 @@ declare module 'fs' {
         /**
          * @default null
          */
-        position?: number | null;
+        position?: ReadPosition | null;
     }
 
     /**
@@ -1545,7 +1542,7 @@ declare module 'fs' {
      * @param length The number of bytes to read.
      * @param position The offset from the beginning of the file from which data should be read. If `null`, data will be read from the current position.
      */
-    export function readSync(fd: number, buffer: NodeJS.ArrayBufferView, offset: number, length: number, position: number | null): number;
+    export function readSync(fd: number, buffer: NodeJS.ArrayBufferView, offset: number, length: number, position: ReadPosition | null): number;
 
     /**
      * Similar to the above `fs.readSync` function, this version takes an optional `options` object.
@@ -1569,7 +1566,6 @@ declare module 'fs' {
     /**
      * Asynchronously reads the entire contents of a file.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options Either the encoding for the result, or an object that contains the encoding and an optional flag.
      * If a flag is not provided, it defaults to `'r'`.
@@ -1583,7 +1579,6 @@ declare module 'fs' {
     /**
      * Asynchronously reads the entire contents of a file.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options Either the encoding for the result, or an object that contains the encoding and an optional flag.
      * If a flag is not provided, it defaults to `'r'`.
@@ -1637,7 +1632,6 @@ declare module 'fs' {
     /**
      * Synchronously reads the entire contents of a file.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options An object that may contain an optional flag. If a flag is not provided, it defaults to `'r'`.
      */
@@ -1646,7 +1640,6 @@ declare module 'fs' {
     /**
      * Synchronously reads the entire contents of a file.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options Either the encoding for the result, or an object that contains the encoding and an optional flag.
      * If a flag is not provided, it defaults to `'r'`.
@@ -1656,7 +1649,6 @@ declare module 'fs' {
     /**
      * Synchronously reads the entire contents of a file.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param options Either the encoding for the result, or an object that contains the encoding and an optional flag.
      * If a flag is not provided, it defaults to `'r'`.
@@ -1668,7 +1660,6 @@ declare module 'fs' {
     /**
      * Asynchronously writes data to a file, replacing the file if it already exists.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      * @param options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
@@ -1682,7 +1673,6 @@ declare module 'fs' {
     /**
      * Asynchronously writes data to a file, replacing the file if it already exists.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      */
@@ -1708,7 +1698,6 @@ declare module 'fs' {
     /**
      * Synchronously writes data to a file, replacing the file if it already exists.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      * @param options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
@@ -1722,7 +1711,6 @@ declare module 'fs' {
     /**
      * Asynchronously append data to a file, creating the file if it does not exist.
      * @param file A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      * @param options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
@@ -1736,7 +1724,6 @@ declare module 'fs' {
     /**
      * Asynchronously append data to a file, creating the file if it does not exist.
      * @param file A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      */
@@ -1762,7 +1749,6 @@ declare module 'fs' {
     /**
      * Synchronously append data to a file, creating the file if it does not exist.
      * @param file A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * If a file descriptor is provided, the underlying file will _not_ be closed automatically.
      * @param data The data to write. If something other than a Buffer or Uint8Array is provided, the value is coerced to a string.
      * @param options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
@@ -1781,36 +1767,36 @@ declare module 'fs' {
     /**
      * Watch for changes on `filename`. The callback `listener` will be called each time the file is accessed.
      * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function watchFile(filename: PathLike, listener: (curr: Stats, prev: Stats) => void): void;
 
     /**
      * Stop watching for changes on `filename`.
      * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function unwatchFile(filename: PathLike, listener?: (curr: Stats, prev: Stats) => void): void;
 
+    export interface WatchOptions extends Abortable {
+        encoding?: BufferEncoding | "buffer";
+        persistent?: boolean;
+        recursive?: boolean;
+    }
+
+    export type WatchListener<T> = (event: "rename" | "change", filename: T) => void;
+
     /**
      * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
      * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * @param options Either the encoding for the filename provided to the listener, or an object optionally specifying encoding, persistent, and recursive options.
      * If `encoding` is not supplied, the default of `'utf8'` is used.
      * If `persistent` is not supplied, the default of `true` is used.
      * If `recursive` is not supplied, the default of `false` is used.
      */
-    export function watch(
-        filename: PathLike,
-        options: { encoding?: BufferEncoding | null, persistent?: boolean, recursive?: boolean } | BufferEncoding | undefined | null,
-        listener?: (event: "rename" | "change", filename: string) => void,
-    ): FSWatcher;
+    export function watch(filename: PathLike, options: WatchOptions & { encoding: "buffer" } | "buffer", listener?: WatchListener<Buffer>): FSWatcher;
 
     /**
      * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
      * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * @param options Either the encoding for the filename provided to the listener, or an object optionally specifying encoding, persistent, and recursive options.
      * If `encoding` is not supplied, the default of `'utf8'` is used.
      * If `persistent` is not supplied, the default of `true` is used.
@@ -1818,37 +1804,30 @@ declare module 'fs' {
      */
     export function watch(
         filename: PathLike,
-        options: { encoding: "buffer", persistent?: boolean, recursive?: boolean; } | "buffer",
-        listener?: (event: "rename" | "change", filename: Buffer) => void
+        options?: WatchOptions | BufferEncoding | null,
+        listener?: WatchListener<string>,
     ): FSWatcher;
 
     /**
      * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
      * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      * @param options Either the encoding for the filename provided to the listener, or an object optionally specifying encoding, persistent, and recursive options.
      * If `encoding` is not supplied, the default of `'utf8'` is used.
      * If `persistent` is not supplied, the default of `true` is used.
      * If `recursive` is not supplied, the default of `false` is used.
      */
-    export function watch(
-        filename: PathLike,
-        options: { encoding?: BufferEncoding | null, persistent?: boolean, recursive?: boolean } | string | null,
-        listener?: (event: "rename" | "change", filename: string | Buffer) => void,
-    ): FSWatcher;
+    export function watch(filename: PathLike, options: WatchOptions | string, listener?: WatchListener<string | Buffer>): FSWatcher;
 
     /**
      * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
      * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
-    export function watch(filename: PathLike, listener?: (event: "rename" | "change", filename: string) => any): FSWatcher;
+    export function watch(filename: PathLike, listener?: WatchListener<string>): FSWatcher;
 
     /**
      * Asynchronously tests whether or not the given path exists by checking with the file system.
      * @deprecated since v1.0.0 Use `fs.stat()` or `fs.access()` instead
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function exists(path: PathLike, callback: (exists: boolean) => void): void;
 
@@ -1864,7 +1843,6 @@ declare module 'fs' {
     /**
      * Synchronously tests whether or not the given path exists by checking with the file system.
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function existsSync(path: PathLike): boolean;
 
@@ -2034,14 +2012,12 @@ declare module 'fs' {
     /**
      * Asynchronously tests a user's permissions for the file specified by path.
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function access(path: PathLike, mode: number | undefined, callback: NoParamCallback): void;
 
     /**
      * Asynchronously tests a user's permissions for the file specified by path.
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function access(path: PathLike, callback: NoParamCallback): void;
 
@@ -2058,7 +2034,6 @@ declare module 'fs' {
     /**
      * Synchronously tests a user's permissions for the file specified by path.
      * @param path A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function accessSync(path: PathLike, mode?: number): void;
 
@@ -2083,14 +2058,12 @@ declare module 'fs' {
     /**
      * Returns a new `ReadStream` object.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function createReadStream(path: PathLike, options?: string | ReadStreamOptions): ReadStream;
 
     /**
      * Returns a new `WriteStream` object.
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
-     * URL support is _experimental_.
      */
     export function createWriteStream(path: PathLike, options?: string | StreamOptions): WriteStream;
 

node/globals.d.ts

@@ -37,9 +37,9 @@ interface ImportMeta {
  ------------------------------------------------*/
 
 // For backwards compability
-interface NodeRequire extends NodeJS.Require {}
-interface RequireResolve extends NodeJS.RequireResolve {}
-interface NodeModule extends NodeJS.Module {}
+interface NodeRequire extends NodeJS.Require { }
+interface RequireResolve extends NodeJS.RequireResolve { }
+interface NodeModule extends NodeJS.Module { }
 
 declare var process: NodeJS.Process;
 declare var console: Console;
@@ -318,6 +318,7 @@ 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.
@@ -341,6 +342,7 @@ declare var AbortController: {
 declare var AbortSignal: {
     prototype: AbortSignal;
     new(): AbortSignal;
+    // TODO: Add abort() static
 };
 //#endregion borrowed
 

node/http.d.ts

@@ -107,7 +107,7 @@ declare module 'http' {
         ServerResponse?: typeof ServerResponse;
         /**
          * Optionally overrides the value of
-         * [`--max-http-header-size`][] for requests received by this server, i.e.
+         * `--max-http-header-size` for requests received by this server, i.e.
          * the maximum length of request headers in bytes.
          * @default 8192
          */
@@ -156,7 +156,8 @@ declare module 'http' {
 
     // https://github.com/nodejs/node/blob/master/lib/_http_outgoing.js
     class OutgoingMessage extends stream.Writable {
-        upgrading: boolean;
+        readonly req: IncomingMessage;
+
         chunkedEncoding: boolean;
         shouldKeepAlive: boolean;
         useChunkedEncodingByDefault: boolean;
@@ -165,12 +166,12 @@ declare module 'http' {
          * @deprecated Use `writableEnded` instead.
          */
         finished: boolean;
-        headersSent: boolean;
+        readonly headersSent: boolean;
         /**
          * @deprecated Use `socket` instead.
          */
-        connection: Socket | null;
-        socket: Socket | null;
+        readonly connection: Socket | null;
+        readonly socket: Socket | null;
 
         constructor();
 
@@ -420,7 +421,14 @@ declare module 'http' {
 
     /**
      * Read-only property specifying the maximum allowed size of HTTP headers in bytes.
-     * Defaults to 16KB. Configurable using the [`--max-http-header-size`][] CLI option.
+     * Defaults to 16KB. Configurable using the `--max-http-header-size` CLI option.
      */
     const maxHeaderSize: number;
+
+    /**
+     *
+     * This utility function converts a URL object into an ordinary options object as
+     * expected by the `http.request()` and `https.request()` APIs.
+     */
+    function urlToHttpOptions(url: URL): ClientRequestArgs;
 }

node/http2.d.ts

@@ -438,6 +438,13 @@ declare module 'http2' {
         paddingStrategy?: number;
         peerMaxConcurrentStreams?: number;
         settings?: Settings;
+        /**
+         * Specifies a timeout in milliseconds that
+         * a server should wait when an [`'unknownProtocol'`][] is emitted. If the
+         * socket has not been destroyed by that time the server will destroy it.
+         * @default 100000
+         */
+        unknownProtocolTimeout?: number;
 
         selectPadding?(frameLen: number, maxFrameLen: number): number;
         createConnection?(authority: url.URL, option: SessionOptions): stream.Duplex;

node/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for non-npm package Node.js 15.6
+// Type definitions for non-npm package Node.js 15.12
 // Project: http://nodejs.org/
 // Definitions by: Microsoft TypeScript <https://github.com/Microsoft>
 //                 DefinitelyTyped <https://github.com/DefinitelyTyped>
@@ -50,9 +50,9 @@
 
 // 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.8
-//          - ~/ts3.5/index.d.ts  - Definitions specific to TypeScript 3.5
+//          - ~/index.d.ts        - Definitions specific to TypeScript 3.7
+//          - ~/ts3.6/index.d.ts  - Definitions specific to TypeScript 3.6
 
-// NOTE: Augmentations for TypeScript 3.5 and later should use individual files for overrides
-//       within the respective ~/ts3.5 (or later) folder. However, this is disallowed for versions
-//       prior to TypeScript 3.5, so the older definitions will be found here.
+// NOTE: Augmentations for TypeScript 3.6 and later should use individual files for overrides
+//       within the respective ~/ts3.6 (or later) folder. However, this is disallowed for versions
+//       prior to TypeScript 3.6, so the older definitions will be found here.

node/os.d.ts

@@ -212,7 +212,7 @@ declare module 'os' {
     /**
      * Returns a string identifying the kernel version.
      * On POSIX systems, the operating system release is determined by calling
-     * [uname(3)][]. On Windows, `pRtlGetVersion` is used, and if it is not available,
+     * uname(3). On Windows, `pRtlGetVersion` is used, and if it is not available,
      * `GetVersionExW()` will be used. See
      * https://en.wikipedia.org/wiki/Uname#Examples for more information.
      */

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "15.6.2",
+    "version": "15.12.2",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -227,6 +227,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "f62422deccbd466260cb63740d207022259eb7fc7b6e7c406be463b9d1b0cd19",
+    "typesPublisherContentHash": "9713490f7bb15f02ab4ef68c39e2ec33cdecadbc39062c33ca86f9e4d8018d9b",
     "typeScriptVersion": "3.6"
 }

node/perf_hooks.d.ts

@@ -3,7 +3,8 @@ declare module 'perf_hooks' {
 
     type EntryType = 'node' | 'mark' | 'measure' | 'gc' | 'function' | 'http2' | 'http';
 
-    interface PerformanceEntry {
+    class PerformanceEntry {
+        protected constructor();
         /**
          * The total number of milliseconds elapsed for this entry.
          * This value will not be meaningful for all Performance Entry types.
@@ -41,7 +42,7 @@ declare module 'perf_hooks' {
         readonly flags?: number;
     }
 
-    interface PerformanceNodeTiming extends PerformanceEntry {
+    class PerformanceNodeTiming extends PerformanceEntry {
         /**
          * The high resolution millisecond timestamp at which the Node.js process completed bootstrap.
          */
@@ -221,15 +222,36 @@ declare module 'perf_hooks' {
         resolution?: number;
     }
 
-    interface EventLoopDelayMonitor {
+    interface Histogram {
         /**
-         * Enables the event loop delay sample timer. Returns `true` if the timer was started, `false` if it was already started.
+         * A `Map` object detailing the accumulated percentile distribution.
          */
-        enable(): boolean;
+        readonly percentiles: Map<number, number>;
+
         /**
-         * Disables the event loop delay sample timer. Returns `true` if the timer was stopped, `false` if it was already stopped.
+         * The number of times the event loop delay exceeded the maximum 1 hour eventloop delay threshold.
          */
-        disable(): boolean;
+        readonly exceeds: number;
+
+        /**
+         * The minimum recorded event loop delay.
+         */
+        readonly min: number;
+
+        /**
+         * The maximum recorded event loop delay.
+         */
+        readonly max: number;
+
+        /**
+         * The mean of the recorded event loop delays.
+         */
+        readonly mean: number;
+
+        /**
+         * The standard deviation of the recorded event loop delays.
+         */
+        readonly stddev: number;
 
         /**
          * Resets the collected histogram data.
@@ -241,37 +263,48 @@ declare module 'perf_hooks' {
          * @param percentile A percentile value between 1 and 100.
          */
         percentile(percentile: number): number;
+    }
 
+    interface IntervalHistogram extends Histogram {
         /**
-         * A `Map` object detailing the accumulated percentile distribution.
+         * Enables the event loop delay sample timer. Returns `true` if the timer was started, `false` if it was already started.
          */
-        readonly percentiles: Map<number, number>;
-
+        enable(): boolean;
         /**
-         * The number of times the event loop delay exceeded the maximum 1 hour eventloop delay threshold.
+         * Disables the event loop delay sample timer. Returns `true` if the timer was stopped, `false` if it was already stopped.
          */
-        readonly exceeds: number;
+        disable(): boolean;
+    }
+
+    interface RecordableHistogram extends Histogram {
+        record(val: number | bigint): void;
 
         /**
-         * The minimum recorded event loop delay.
+         * Calculates the amount of time (in nanoseconds) that has passed since the previous call to recordDelta() and records that amount in the histogram.
          */
-        readonly min: number;
+        recordDelta(): void;
+    }
+
+    function monitorEventLoopDelay(options?: EventLoopMonitorOptions): IntervalHistogram;
 
+    interface CreateHistogramOptions {
         /**
-         * The maximum recorded event loop delay.
+         * The minimum recordable value. Must be an integer value greater than 0.
+         * @default 1
          */
-        readonly max: number;
+        min?: number | bigint;
 
         /**
-         * The mean of the recorded event loop delays.
+         * The maximum recordable value. Must be an integer value greater than min.
+         * @default Number.MAX_SAFE_INTEGER
          */
-        readonly mean: number;
-
+        max?: number | bigint;
         /**
-         * The standard deviation of the recorded event loop delays.
+         * The number of accuracy digits. Must be a number between 1 and 5.
+         * @default 3
          */
-        readonly stddev: number;
+        figures?: number;
     }
 
-    function monitorEventLoopDelay(options?: EventLoopMonitorOptions): EventLoopDelayMonitor;
+    function createHistogram(options?: CreateHistogramOptions): RecordableHistogram;
 }

node/process.d.ts

@@ -336,7 +336,7 @@ declare module 'process' {
 
                 /**
                  * The `process.allowedNodeEnvironmentFlags` property is a special,
-                 * read-only `Set` of flags allowable within the [`NODE_OPTIONS`][]
+                 * read-only `Set` of flags allowable within the `NODE_OPTIONS`
                  * environment variable.
                  */
                 allowedNodeEnvironmentFlags: ReadonlySet<string>;

node/readline.d.ts

@@ -1,5 +1,5 @@
 declare module 'readline' {
-    import EventEmitter = require('events');
+    import { Abortable, EventEmitter } from 'events';
 
     interface Key {
         sequence?: string;
@@ -42,6 +42,7 @@ declare module 'readline' {
         setPrompt(prompt: string): void;
         prompt(preserveCursor?: boolean): void;
         question(query: string, callback: (answer: string) => void): void;
+        question(query: string, options: Abortable, callback: (answer: string) => void): void;
         pause(): this;
         resume(): this;
         close(): void;
@@ -63,8 +64,8 @@ declare module 'readline' {
          * 5. SIGCONT
          * 6. SIGINT
          * 7. SIGTSTP
+         * 8. history
          */
-
         addListener(event: string, listener: (...args: any[]) => void): this;
         addListener(event: "close", listener: () => void): this;
         addListener(event: "line", listener: (input: string) => void): this;
@@ -73,6 +74,7 @@ declare module 'readline' {
         addListener(event: "SIGCONT", listener: () => void): this;
         addListener(event: "SIGINT", listener: () => void): this;
         addListener(event: "SIGTSTP", listener: () => void): this;
+        addListener(event: "history", listener: (history: string[]) => void): this;
 
         emit(event: string | symbol, ...args: any[]): boolean;
         emit(event: "close"): boolean;
@@ -82,6 +84,7 @@ declare module 'readline' {
         emit(event: "SIGCONT"): boolean;
         emit(event: "SIGINT"): boolean;
         emit(event: "SIGTSTP"): boolean;
+        emit(event: "history", history: string[]): boolean;
 
         on(event: string, listener: (...args: any[]) => void): this;
         on(event: "close", listener: () => void): this;
@@ -91,6 +94,7 @@ declare module 'readline' {
         on(event: "SIGCONT", listener: () => void): this;
         on(event: "SIGINT", listener: () => void): this;
         on(event: "SIGTSTP", listener: () => void): this;
+        on(event: "history", listener: (history: string[]) => void): this;
 
         once(event: string, listener: (...args: any[]) => void): this;
         once(event: "close", listener: () => void): this;
@@ -100,6 +104,7 @@ declare module 'readline' {
         once(event: "SIGCONT", listener: () => void): this;
         once(event: "SIGINT", listener: () => void): this;
         once(event: "SIGTSTP", listener: () => void): this;
+        once(event: "history", listener: (history: string[]) => void): this;
 
         prependListener(event: string, listener: (...args: any[]) => void): this;
         prependListener(event: "close", listener: () => void): this;
@@ -109,6 +114,7 @@ declare module 'readline' {
         prependListener(event: "SIGCONT", listener: () => void): this;
         prependListener(event: "SIGINT", listener: () => void): this;
         prependListener(event: "SIGTSTP", listener: () => void): this;
+        prependListener(event: "history", listener: (history: string[]) => void): this;
 
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
         prependOnceListener(event: "close", listener: () => void): this;
@@ -118,6 +124,8 @@ declare module 'readline' {
         prependOnceListener(event: "SIGCONT", listener: () => void): this;
         prependOnceListener(event: "SIGINT", listener: () => void): this;
         prependOnceListener(event: "SIGTSTP", listener: () => void): this;
+        prependOnceListener(event: "history", listener: (history: string[]) => void): this;
+
         [Symbol.asyncIterator](): AsyncIterableIterator<string>;
     }
 
@@ -133,9 +141,22 @@ declare module 'readline' {
         output?: NodeJS.WritableStream;
         completer?: Completer | AsyncCompleter;
         terminal?: boolean;
+        /**
+         *  Initial list of history lines. This option makes sense
+         * only if `terminal` is set to `true` by the user or by an internal `output`
+         * check, otherwise the history caching mechanism is not initialized at all.
+         * @default []
+         */
+        history?: string[];
         historySize?: number;
         prompt?: string;
         crlfDelay?: number;
+        /**
+         * If `true`, when a new input line added
+         * to the history list duplicates an older one, this removes the older line
+         * from the list.
+         * @default false
+         */
         removeHistoryDuplicates?: boolean;
         escapeCodeTimeout?: number;
         tabSize?: number;