@types/node 15.3.1 → 15.9.0

node/fs.d.ts

@@ -1,6 +1,6 @@
 declare module 'fs' {
     import * as stream from 'stream';
-    import EventEmitter = require('events');
+    import { Abortable, EventEmitter } from 'events';
     import { URL } from 'url';
     import * as promises from 'fs/promises';
 
@@ -142,11 +142,6 @@ declare module 'fs' {
         prependOnceListener(event: "close", listener: () => void): this;
     }
 
-    // TODO: Move this to a more central location
-    export interface Abortable {
-        signal?: AbortSignal;
-    }
-
     export class ReadStream extends stream.Readable {
         close(): void;
         bytesRead: number;
@@ -281,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;
 
@@ -302,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;
 
@@ -318,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;
 
@@ -1247,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 {
@@ -1492,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.
@@ -1505,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;
 
@@ -1539,7 +1531,7 @@ declare module 'fs' {
         /**
          * @default null
          */
-        position?: number | null;
+        position?: ReadPosition | null;
     }
 
     /**
@@ -1550,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.
@@ -1574,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'`.
@@ -1588,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'`.
@@ -1642,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'`.
      */
@@ -1651,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'`.
@@ -1661,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'`.
@@ -1673,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.
@@ -1687,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.
      */
@@ -1713,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.
@@ -1727,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.
@@ -1741,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.
      */
@@ -1767,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.
@@ -1786,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.
@@ -1823,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;
 
@@ -1869,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;
 
@@ -2039,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;
 
@@ -2063,19 +2034,13 @@ 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;
 
-    /**
-     * 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 | {
+    interface StreamOptions {
         flags?: string;
         encoding?: BufferEncoding;
-        fd?: number;
+        fd?: number | promises.FileHandle;
         mode?: number;
         autoClose?: boolean;
         /**
@@ -2083,25 +2048,24 @@ declare module 'fs' {
          */
         emitClose?: boolean;
         start?: number;
-        end?: number;
         highWaterMark?: number;
-    }): ReadStream;
+    }
+
+    interface ReadStreamOptions extends StreamOptions {
+        end?: number;
+    }
+
+    /**
+     * Returns a new `ReadStream` object.
+     * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
+     */
+    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 | {
-        flags?: string;
-        encoding?: BufferEncoding;
-        fd?: number;
-        mode?: number;
-        autoClose?: boolean;
-        emitClose?: boolean;
-        start?: number;
-        highWaterMark?: number;
-    }): WriteStream;
+    export function createWriteStream(path: PathLike, options?: string | StreamOptions): WriteStream;
 
     /**
      * Asynchronous fdatasync(2) - synchronize a file's in-core state with storage device.

node/globals.d.ts

@@ -622,6 +622,10 @@ declare namespace NodeJS {
         '.node': (m: Module, filename: string) => any;
     }
     interface Module {
+        /**
+         * `true` if the module is running during the Node.js preload
+         */
+        isPreloading: boolean;
         exports: any;
         require: Require;
         id: string;

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,17 +166,17 @@ declare module 'http' {
          * @deprecated Use `writableEnded` instead.
          */
         finished: boolean;
-        headersSent: boolean;
+        readonly headersSent: boolean;
         /**
-         * @deprecate Use `socket` instead.
+         * @deprecated Use `socket` instead.
          */
-        connection: Socket | null;
-        socket: Socket | null;
+        readonly connection: Socket | null;
+        readonly socket: Socket | null;
 
         constructor();
 
         setTimeout(msecs: number, callback?: () => void): this;
-        setHeader(name: string, value: number | string | ReadonlyArray<string>): void;
+        setHeader(name: string, value: number | string | ReadonlyArray<string>): this;
         getHeader(name: string): number | string | string[] | undefined;
         getHeaders(): OutgoingHttpHeaders;
         getHeaderNames(): string[];
@@ -374,7 +375,8 @@ declare module 'http' {
          */
         timeout?: number;
         /**
-         * Scheduling strategy to apply when picking the next free socket to use. Default: 'fifo'.
+         * Scheduling strategy to apply when picking the next free socket to use.
+         * @default `lifo`
          */
         scheduling?: 'fifo' | 'lifo';
     }
@@ -419,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/index.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for non-npm package Node.js 15.3
+// Type definitions for non-npm package Node.js 15.9
 // Project: http://nodejs.org/
 // Definitions by: Microsoft TypeScript <https://github.com/Microsoft>
 //                 DefinitelyTyped <https://github.com/DefinitelyTyped>

node/net.d.ts

@@ -1,6 +1,6 @@
 declare module 'net' {
     import * as stream from 'stream';
-    import EventEmitter = require('events');
+    import { Abortable, EventEmitter } from 'events';
     import * as dns from 'dns';
 
     type LookupFunction = (
@@ -168,7 +168,7 @@ declare module 'net' {
         prependOnceListener(event: "timeout", listener: () => void): this;
     }
 
-    interface ListenOptions {
+    interface ListenOptions extends Abortable {
         port?: number;
         host?: string;
         backlog?: number;

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,7 +1,8 @@
 {
     "name": "@types/node",
-    "version": "15.3.1",
+    "version": "15.9.0",
     "description": "TypeScript definitions for Node.js",
+    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
     "contributors": [
         {
@@ -226,6 +227,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "5487ee1e7936fac57cddce52c08f0af61a7f0067c859eb399f5234be24a3e9f9",
-    "typeScriptVersion": "3.5"
+    "typesPublisherContentHash": "cb014fbf92870923982004e4fca76f59150c147625c5fc51365d369f858eb620",
+    "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.
          */
@@ -88,7 +89,10 @@ declare module 'perf_hooks' {
      * @param util1 The result of a previous call to eventLoopUtilization()
      * @param util2 The result of a previous call to eventLoopUtilization() prior to util1
      */
-    type EventLoopUtilityFunction = (util1?: EventLoopUtilization, util2?: EventLoopUtilization) => EventLoopUtilization;
+    type EventLoopUtilityFunction = (
+        util1?: EventLoopUtilization,
+        util2?: EventLoopUtilization,
+    ) => EventLoopUtilization;
 
     interface Performance {
         /**
@@ -122,7 +126,7 @@ declare module 'perf_hooks' {
          * @param startMark
          * @param endMark
          */
-        measure(name: string, startMark: string, endMark: string): void;
+        measure(name: string, startMark?: string, endMark?: string): void;
 
         /**
          * An instance of the PerformanceNodeTiming class that provides performance metrics for specific Node.js operational milestones.
@@ -218,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.
@@ -238,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

@@ -11,6 +11,18 @@ declare module 'process' {
             interface ReadStream extends tty.ReadStream {}
             interface WriteStream extends tty.WriteStream {}
 
+            interface MemoryUsageFn {
+                /**
+                 * The `process.memoryUsage()` method iterate over each page to gather informations about memory
+                 * usage which can be slow depending on the program memory allocations.
+                 */
+                (): MemoryUsage;
+                /**
+                 * method returns an integer representing the Resident Set Size (RSS) in bytes.
+                 */
+                rss(): number;
+            }
+
             interface MemoryUsage {
                 rss: number;
                 heapTotal: number;
@@ -289,7 +301,7 @@ declare module 'process' {
                 platform: Platform;
                 /** @deprecated since v14.0.0 - use `require.main` instead. */
                 mainModule?: Module;
-                memoryUsage(): MemoryUsage;
+                memoryUsage: MemoryUsageFn;
                 cpuUsage(previousValue?: CpuUsage): CpuUsage;
                 nextTick(callback: Function, ...args: any[]): void;
                 release: ProcessRelease;
@@ -324,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>;