@types/node 16.4.6 → 16.4.10

node/fs/promises.d.ts

@@ -108,8 +108,8 @@ declare module 'fs/promises' {
          * number of bytes read is zero.
          * @since v10.0.0
          * @param buffer A buffer that will be filled with the file data read.
-         * @param offset The location in the buffer at which to start filling.
-         * @param length The number of bytes to read.
+         * @param [offset=0] The location in the buffer at which to start filling.
+         * @param [length=buffer.byteLength] The number of bytes to read.
          * @param position The location where to begin reading data from the file. If `null`, data will be read from the current file position, and the position will be updated. If `position` is an
          * integer, the current file position will remain unchanged.
          * @return Fulfills upon success with an object with two properties:
@@ -204,6 +204,7 @@ declare module 'fs/promises' {
          *
          * If `len` is negative then `0` will be used.
          * @since v10.0.0
+         * @param [len=0]
          * @return Fulfills with `undefined` upon success.
          */
         truncate(len?: number): Promise<void>;
@@ -242,8 +243,8 @@ declare module 'fs/promises' {
          * The kernel ignores the position argument and always appends the data to
          * the end of the file.
          * @since v10.0.0
-         * @param offset The start position from within `buffer` where the data to write begins.
-         * @param length The number of bytes from `buffer` to write.
+         * @param [offset=0] The start position from within `buffer` where the data to write begins.
+         * @param [length=buffer.byteLength] The number of bytes from `buffer` to write.
          * @param position The offset from the beginning of the file where the data from `buffer` should be written. If `position` is not a `number`, the data will be written at the current position.
          * See the POSIX pwrite(2) documentation for more detail.
          */
@@ -336,6 +337,7 @@ declare module 'fs/promises' {
      * calls. Instead, user code should open/read/write the file directly and handle
      * the error raised if the file is not accessible.
      * @since v10.0.0
+     * @param [mode=fs.constants.F_OK]
      * @return Fulfills with `undefined` upon success.
      */
     function access(path: PathLike, mode?: number): Promise<void>;
@@ -369,7 +371,7 @@ declare module 'fs/promises' {
      * @since v10.0.0
      * @param src source filename to copy
      * @param dest destination filename of the copy operation
-     * @param mode Optional modifiers that specify the behavior of the copy operation. It is possible to create a mask consisting of the bitwise OR of two or more values (e.g.
+     * @param [mode=0] Optional modifiers that specify the behavior of the copy operation. It is possible to create a mask consisting of the bitwise OR of two or more values (e.g.
      * `fs.constants.COPYFILE_EXCL | fs.constants.COPYFILE_FICLONE`)
      * @return Fulfills with `undefined` upon success.
      */
@@ -383,8 +385,8 @@ declare module 'fs/promises' {
      * by [Naming Files, Paths, and Namespaces](https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file). Under NTFS, if the filename contains
      * a colon, Node.js will open a file system stream, as described by[this MSDN page](https://docs.microsoft.com/en-us/windows/desktop/FileIO/using-streams).
      * @since v10.0.0
-     * @param flags See `support of file system `flags``.
-     * @param mode Sets the file mode (permission and sticky bits) if the file is created.
+     * @param [flags='r'] See `support of file system `flags``.
+     * @param [mode=0o666] Sets the file mode (permission and sticky bits) if the file is created.
      * @return Fulfills with a {FileHandle} object.
      */
     function open(path: PathLike, flags: string | number, mode?: Mode): Promise<FileHandle>;
@@ -397,6 +399,7 @@ declare module 'fs/promises' {
     /**
      * Truncates (shortens or extends the length) of the content at `path` to `len`bytes.
      * @since v10.0.0
+     * @param [len=0]
      * @return Fulfills with `undefined` upon success.
      */
     function truncate(path: PathLike, len?: number): Promise<void>;
@@ -558,6 +561,7 @@ declare module 'fs/promises' {
      * to be absolute. When using `'junction'`, the `target` argument will
      * automatically be normalized to absolute path.
      * @since v10.0.0
+     * @param [type='file']
      * @return Fulfills with `undefined` upon success.
      */
     function symlink(target: PathLike, path: PathLike, type?: string | null): Promise<void>;

node/fs.d.ts

@@ -305,8 +305,6 @@ declare module 'fs' {
         prependOnceListener(event: 'close', listener: () => void): this;
     }
     /**
-     * * Extends: `<stream.Readable>`
-     *
      * Instances of `<fs.ReadStream>` are created and returned using the {@link createReadStream} function.
      * @since v0.1.93
      */
@@ -518,6 +516,7 @@ declare module 'fs' {
      *
      * See the POSIX [`truncate(2)`](http://man7.org/linux/man-pages/man2/truncate.2.html) documentation for more details.
      * @since v0.8.6
+     * @param [len=0]
      */
     export function truncate(path: PathLike, len: number | undefined | null, callback: NoParamCallback): void;
     /**
@@ -540,6 +539,7 @@ declare module 'fs' {
      * Passing a file descriptor is deprecated and may result in an error being thrown
      * in the future.
      * @since v0.8.6
+     * @param [len=0]
      */
     export function truncateSync(path: PathLike, len?: number | null): void;
     /**
@@ -583,6 +583,7 @@ declare module 'fs' {
      *
      * If `len` is negative then `0` will be used.
      * @since v0.8.6
+     * @param [len=0]
      */
     export function ftruncate(fd: number, len: number | undefined | null, callback: NoParamCallback): void;
     /**
@@ -604,6 +605,7 @@ declare module 'fs' {
      * For detailed information, see the documentation of the asynchronous version of
      * this API: {@link ftruncate}.
      * @since v0.8.6
+     * @param [len=0]
      */
     export function ftruncateSync(fd: number, len?: number | null): void;
     /**
@@ -1954,7 +1956,8 @@ declare module 'fs' {
      *
      * Functions based on `fs.open()` exhibit this behavior as well:`fs.writeFile()`, `fs.readFile()`, etc.
      * @since v0.0.2
-     * @param flags See `support of file system `flags``.
+     * @param [flags='r'] See `support of file system `flags``.
+     * @param [mode=0o666]
      */
     export function open(path: PathLike, flags: OpenMode, mode: Mode | undefined | null, callback: (err: NodeJS.ErrnoException | null, fd: number) => void): void;
     /**
@@ -1976,6 +1979,8 @@ declare module 'fs' {
      * For detailed information, see the documentation of the asynchronous version of
      * this API: {@link open}.
      * @since v0.1.21
+     * @param [flags='r']
+     * @param [mode=0o666]
      */
     export function openSync(path: PathLike, flags: OpenMode, mode?: Mode | null): number;
     /**
@@ -2198,9 +2203,9 @@ declare module 'fs' {
      * If this method is invoked as its `util.promisify()` ed version, it returns
      * a promise for an `Object` with `bytesRead` and `buffer` properties.
      * @since v0.0.2
-     * @param buffer The buffer that the data will be written to.
-     * @param offset The position in `buffer` to write the data to.
-     * @param length The number of bytes to read.
+     * @param [buffer=Buffer.alloc(16384)] The buffer that the data will be written to.
+     * @param [offset=0] The position in `buffer` to write the data to.
+     * @param [length=buffer.byteLength] The number of bytes to read.
      * @param position Specifies where to begin reading from in the file. If `position` is `null` or `-1 `, data will be read from the current file position, and the file position will be updated. If
      * `position` is an integer, the file position will be unchanged.
      */
@@ -2805,6 +2810,7 @@ declare module 'fs' {
      * If a `signal` is passed, aborting the corresponding AbortController will close
      * the returned `<fs.FSWatcher>`.
      * @since v0.5.10
+     * @param listener
      */
     export function watch(
         filename: PathLike,
@@ -3270,6 +3276,7 @@ declare module 'fs' {
      * ACL and therefore may report that a path is accessible even if the ACL restricts
      * the user from reading or writing to it.
      * @since v0.11.15
+     * @param [mode=fs.constants.F_OK]
      */
     export function access(path: PathLike, mode: number | undefined, callback: NoParamCallback): void;
     /**
@@ -3307,6 +3314,7 @@ declare module 'fs' {
      * }
      * ```
      * @since v0.11.15
+     * @param [mode=fs.constants.F_OK]
      */
     export function accessSync(path: PathLike, mode?: number): void;
     interface StreamOptions {
@@ -3389,7 +3397,7 @@ declare module 'fs' {
      * @since v0.1.31
      * @return See `Readable Stream`.
      */
-    export function createReadStream(path: PathLike, options?: string | ReadStreamOptions): ReadStream;
+    export function createReadStream(path: PathLike, options?: BufferEncoding | ReadStreamOptions): ReadStream;
     /**
      * `options` may also include a `start` option to allow writing data at some
      * position past the beginning of the file, allowed values are in the
@@ -3417,7 +3425,7 @@ declare module 'fs' {
      * @since v0.1.31
      * @return See `Writable Stream`.
      */
-    export function createWriteStream(path: PathLike, options?: string | StreamOptions): WriteStream;
+    export function createWriteStream(path: PathLike, options?: BufferEncoding | StreamOptions): WriteStream;
     /**
      * Forces all currently queued I/O operations associated with the file to the
      * operating system's synchronized I/O completion state. Refer to the POSIX[`fdatasync(2)`](http://man7.org/linux/man-pages/man2/fdatasync.2.html) documentation for details. No arguments other
@@ -3476,7 +3484,7 @@ declare module 'fs' {
      * @since v8.5.0
      * @param src source filename to copy
      * @param dest destination filename of the copy operation
-     * @param mode modifiers for copy operation.
+     * @param [mode=0] modifiers for copy operation.
      */
     export function copyFile(src: PathLike, dest: PathLike, callback: NoParamCallback): void;
     export function copyFile(src: PathLike, dest: PathLike, mode: number, callback: NoParamCallback): void;
@@ -3515,7 +3523,7 @@ declare module 'fs' {
      * @since v8.5.0
      * @param src source filename to copy
      * @param dest destination filename of the copy operation
-     * @param mode modifiers for copy operation.
+     * @param [mode=0] modifiers for copy operation.
      */
     export function copyFileSync(src: PathLike, dest: PathLike, mode?: number): void;
     /**

node/http.d.ts

@@ -182,7 +182,6 @@ declare module 'http' {
     }
     interface Server extends HttpBase {}
     /**
-     * * Extends: `<net.Server>`
      * @since v0.1.17
      */
     class Server extends NetServer {
@@ -620,8 +619,6 @@ declare module 'http' {
         prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
     }
     /**
-     * * Extends: `<stream.Readable>`
-     *
      * An `IncomingMessage` object is created by {@link Server} or {@link ClientRequest} and passed as the first argument to the `'request'` and `'response'` event respectively. It may be used to
      * access response
      * status, headers and data.
@@ -677,7 +674,7 @@ declare module 'http' {
         /**
          * Alias for `message.socket`.
          * @since v0.1.90
-         * @deprecated Since v16.0.0 - Deprecated. Use `socket`.
+         * @deprecated Since v16.0.0 - Use `socket`.
          */
         connection: Socket;
         /**

node/http2.d.ts

@@ -140,7 +140,7 @@ declare module 'http2' {
          * Closes the `Http2Stream` instance by sending an `RST_STREAM` frame to the
          * connected HTTP/2 peer.
          * @since v8.4.0
-         * @param code Unsigned 32-bit integer identifying the error code.
+         * @param [code=http2.constants.NGHTTP2_NO_ERROR] Unsigned 32-bit integer identifying the error code.
          * @param callback An optional function registered to listen for the `'close'` event.
          */
         close(code?: number, callback?: () => void): void;
@@ -1170,8 +1170,6 @@ declare module 'http2' {
         prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
     }
     /**
-     * * Extends: `<stream.Readable>`
-     *
      * A `Http2ServerRequest` object is created by {@link Server} or {@link SecureServer} and passed as the first argument to the `'request'` event. It may be used to access a request status,
      * headers, and
      * data.
@@ -1194,7 +1192,7 @@ declare module 'http2' {
         /**
          * See `request.socket`.
          * @since v8.4.0
-         * @deprecated Since v13.0.0 - Deprecated. Use `socket`.
+         * @deprecated Since v13.0.0 - Use `socket`.
          */
         readonly connection: net.Socket | tls.TLSSocket;
         /**
@@ -1417,14 +1415,14 @@ declare module 'http2' {
         /**
          * See `response.socket`.
          * @since v8.4.0
-         * @deprecated Since v13.0.0 - Deprecated. Use `socket`.
+         * @deprecated Since v13.0.0 - Use `socket`.
          */
         readonly connection: net.Socket | tls.TLSSocket;
         /**
          * Boolean value that indicates whether the response has completed. Starts
          * as `false`. After `response.end()` executes, the value will be `true`.
          * @since v8.4.0
-         * @deprecated Since v13.4.0,v12.16.0 - Deprecated. Use `writableEnded`.
+         * @deprecated Since v13.4.0,v12.16.0 - Use `writableEnded`.
          */
         readonly finished: boolean;
         /**
@@ -1437,10 +1435,66 @@ declare module 'http2' {
          * @since v15.7.0
          */
         readonly req: Http2ServerRequest;
+        /**
+         * Returns a `Proxy` object that acts as a `net.Socket` (or `tls.TLSSocket`) but
+         * applies getters, setters, and methods based on HTTP/2 logic.
+         *
+         * `destroyed`, `readable`, and `writable` properties will be retrieved from and
+         * set on `response.stream`.
+         *
+         * `destroy`, `emit`, `end`, `on` and `once` methods will be called on`response.stream`.
+         *
+         * `setTimeout` method will be called on `response.stream.session`.
+         *
+         * `pause`, `read`, `resume`, and `write` will throw an error with code`ERR_HTTP2_NO_SOCKET_MANIPULATION`. See `Http2Session and Sockets` for
+         * more information.
+         *
+         * All other interactions will be routed directly to the socket.
+         *
+         * ```js
+         * const http2 = require('http2');
+         * const server = http2.createServer((req, res) => {
+         *   const ip = req.socket.remoteAddress;
+         *   const port = req.socket.remotePort;
+         *   res.end(`Your IP address is ${ip} and your source port is ${port}.`);
+         * }).listen(3000);
+         * ```
+         * @since v8.4.0
+         */
         readonly socket: net.Socket | tls.TLSSocket;
+        /**
+         * The `Http2Stream` object backing the response.
+         * @since v8.4.0
+         */
         readonly stream: ServerHttp2Stream;
+        /**
+         * When true, the Date header will be automatically generated and sent in
+         * the response if it is not already present in the headers. Defaults to true.
+         *
+         * This should only be disabled for testing; HTTP requires the Date header
+         * in responses.
+         * @since v8.4.0
+         */
         sendDate: boolean;
+        /**
+         * When using implicit headers (not calling `response.writeHead()` explicitly),
+         * this property controls the status code that will be sent to the client when
+         * the headers get flushed.
+         *
+         * ```js
+         * response.statusCode = 404;
+         * ```
+         *
+         * After response header was sent to the client, this property indicates the
+         * status code which was sent out.
+         * @since v8.4.0
+         */
         statusCode: number;
+        /**
+         * Status message is not supported by HTTP/2 (RFC 7540 8.1.2.4). It returns
+         * an empty string.
+         * @since v8.4.0
+         */
         statusMessage: '';
         /**
          * This method adds HTTP trailing headers (a header but at the end of the

node/https.d.ts

@@ -27,8 +27,6 @@ declare module 'https' {
     }
     interface Server extends http.HttpBase {}
     /**
-     * * Extends: `<tls.Server>`
-     *
      * See `http.Server` for more information.
      * @since v0.3.4
      */

node/module.d.ts

@@ -66,6 +66,9 @@ declare module 'module' {
          * @since v13.7.0, v12.17.0
          */
         class SourceMap {
+            /**
+             * Getter for the payload used to construct the `SourceMap` instance.
+             */
             readonly payload: SourceMapPayload;
             constructor(payload: SourceMapPayload);
             /**

node/net.d.ts

@@ -59,8 +59,6 @@ declare module 'net' {
     }
     type SocketConnectOpts = TcpSocketConnectOpts | IpcSocketConnectOpts;
     /**
-     * * Extends: `<stream.Duplex>`
-     *
      * This class is an abstraction of a TCP socket or a streaming `IPC` endpoint
      * (uses named pipes on Windows, and Unix domain sockets otherwise). It is also
      * an `EventEmitter`.
@@ -89,7 +87,7 @@ declare module 'net' {
          * See `Writable` stream `write()` method for more
          * information.
          * @since v0.1.90
-         * @param encoding Only used when data is `string`.
+         * @param [encoding='utf8'] Only used when data is `string`.
          */
         write(buffer: Uint8Array | string, cb?: (err?: Error) => void): boolean;
         write(str: Uint8Array | string, encoding?: BufferEncoding, cb?: (err?: Error) => void): boolean;
@@ -167,6 +165,7 @@ declare module 'net' {
          * algorithm for the socket. Passing `false` for `noDelay` will enable Nagle's
          * algorithm.
          * @since v0.1.90
+         * @param [noDelay=true]
          * @return The socket itself.
          */
         setNoDelay(noDelay?: boolean): this;
@@ -185,6 +184,8 @@ declare module 'net' {
          * * `TCP_KEEPCNT=10`
          * * `TCP_KEEPINTVL=1`
          * @since v0.1.92
+         * @param [enable=false]
+         * @param [initialDelay=0]
          * @return The socket itself.
          */
         setKeepAlive(enable?: boolean, initialDelay?: number): this;
@@ -282,7 +283,7 @@ declare module 'net' {
          *
          * See `writable.end()` for further details.
          * @since v0.1.90
-         * @param encoding Only used when data is `string`.
+         * @param [encoding='utf8'] Only used when data is `string`.
          * @param callback Optional callback for when the socket is finished.
          * @return The socket itself.
          */
@@ -308,6 +309,7 @@ declare module 'net' {
         addListener(event: 'end', listener: () => void): this;
         addListener(event: 'error', listener: (err: Error) => void): this;
         addListener(event: 'lookup', listener: (err: Error, address: string, family: string | number, host: string) => void): this;
+        addListener(event: 'ready', listener: () => void): this;
         addListener(event: 'timeout', listener: () => void): this;
         emit(event: string | symbol, ...args: any[]): boolean;
         emit(event: 'close', hadError: boolean): boolean;
@@ -317,6 +319,7 @@ declare module 'net' {
         emit(event: 'end'): boolean;
         emit(event: 'error', err: Error): boolean;
         emit(event: 'lookup', err: Error, address: string, family: string | number, host: string): boolean;
+        emit(event: 'ready'): boolean;
         emit(event: 'timeout'): boolean;
         on(event: string, listener: (...args: any[]) => void): this;
         on(event: 'close', listener: (hadError: boolean) => void): this;
@@ -326,6 +329,7 @@ declare module 'net' {
         on(event: 'end', listener: () => void): this;
         on(event: 'error', listener: (err: Error) => void): this;
         on(event: 'lookup', listener: (err: Error, address: string, family: string | number, host: string) => void): this;
+        on(event: 'ready', listener: () => void): this;
         on(event: 'timeout', listener: () => void): this;
         once(event: string, listener: (...args: any[]) => void): this;
         once(event: 'close', listener: (hadError: boolean) => void): this;
@@ -335,6 +339,7 @@ declare module 'net' {
         once(event: 'end', listener: () => void): this;
         once(event: 'error', listener: (err: Error) => void): this;
         once(event: 'lookup', listener: (err: Error, address: string, family: string | number, host: string) => void): this;
+        once(event: 'ready', listener: () => void): this;
         once(event: 'timeout', listener: () => void): this;
         prependListener(event: string, listener: (...args: any[]) => void): this;
         prependListener(event: 'close', listener: (hadError: boolean) => void): this;
@@ -344,6 +349,7 @@ declare module 'net' {
         prependListener(event: 'end', listener: () => void): this;
         prependListener(event: 'error', listener: (err: Error) => void): this;
         prependListener(event: 'lookup', listener: (err: Error, address: string, family: string | number, host: string) => void): this;
+        prependListener(event: 'ready', listener: () => void): this;
         prependListener(event: 'timeout', listener: () => void): this;
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
         prependOnceListener(event: 'close', listener: (hadError: boolean) => void): this;
@@ -353,6 +359,7 @@ declare module 'net' {
         prependOnceListener(event: 'end', listener: () => void): this;
         prependOnceListener(event: 'error', listener: (err: Error) => void): this;
         prependOnceListener(event: 'lookup', listener: (err: Error, address: string, family: string | number, host: string) => void): this;
+        prependOnceListener(event: 'ready', listener: () => void): this;
         prependOnceListener(event: 'timeout', listener: () => void): this;
     }
     interface ListenOptions extends Abortable {
@@ -560,7 +567,7 @@ declare module 'net' {
          * Adds a rule to block the given IP address.
          * @since v15.0.0
          * @param address An IPv4 or IPv6 address.
-         * @param type Either `'ipv4'` or `'ipv6'`.
+         * @param [type='ipv4'] Either `'ipv4'` or `'ipv6'`.
          */
         addAddress(address: string, type?: IPVersion): void;
         addAddress(address: SocketAddress): void;
@@ -569,7 +576,7 @@ declare module 'net' {
          * @since v15.0.0
          * @param start The starting IPv4 or IPv6 address in the range.
          * @param end The ending IPv4 or IPv6 address in the range.
-         * @param type Either `'ipv4'` or `'ipv6'`.
+         * @param [type='ipv4'] Either `'ipv4'` or `'ipv6'`.
          */
         addRange(start: string, end: string, type?: IPVersion): void;
         addRange(start: SocketAddress, end: SocketAddress): void;
@@ -578,7 +585,7 @@ declare module 'net' {
          * @since v15.0.0
          * @param net The network IPv4 or IPv6 address.
          * @param prefix The number of CIDR prefix bits. For IPv4, this must be a value between `0` and `32`. For IPv6, this must be between `0` and `128`.
-         * @param type Either `'ipv4'` or `'ipv6'`.
+         * @param [type='ipv4'] Either `'ipv4'` or `'ipv6'`.
          */
         addSubnet(net: SocketAddress, prefix: number): void;
         addSubnet(net: string, prefix: number, type?: IPVersion): void;
@@ -601,7 +608,7 @@ declare module 'net' {
          * ```
          * @since v15.0.0
          * @param address The IP address to check
-         * @param type Either `'ipv4'` or `'ipv6'`.
+         * @param [type='ipv4'] Either `'ipv4'` or `'ipv6'`.
          */
         check(address: SocketAddress): boolean;
         check(address: string, type?: IPVersion): boolean;

node/os.d.ts

@@ -430,7 +430,7 @@ declare module 'os' {
      * Returns the scheduling priority for the process specified by `pid`. If `pid` is
      * not provided or is `0`, the priority of the current process is returned.
      * @since v10.10.0
-     * @param pid The process ID to retrieve scheduling priority for.
+     * @param [pid=0] The process ID to retrieve scheduling priority for.
      */
     function getPriority(pid?: number): number;
     /**
@@ -444,7 +444,7 @@ declare module 'os' {
      * On Windows, setting priority to `PRIORITY_HIGHEST` requires elevated user
      * privileges. Otherwise the set priority will be silently reduced to`PRIORITY_HIGH`.
      * @since v10.10.0
-     * @param pid The process ID to set scheduling priority for.
+     * @param [pid=0] The process ID to set scheduling priority for.
      * @param priority The scheduling priority to assign to the process.
      */
     function setPriority(priority: number): void;

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "16.4.6",
+    "version": "16.4.10",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -232,6 +232,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "409fea0ec0757dc100114c6d35fe3b616cdf1e1095e08f5e2f83bd9336035435",
+    "typesPublisherContentHash": "9cf7378268559fe669acee51f22c860ed9146ba1d1de171f48e6c74c851194b6",
     "typeScriptVersion": "3.6"
 }

node/process.d.ts

@@ -579,7 +579,7 @@ declare module 'process' {
                  * In `Worker` threads, this function stops the current thread rather
                  * than the current process.
                  * @since v0.1.13
-                 * @param code The exit code.
+                 * @param [code=0] The exit code.
                  */
                 exit(code?: number): never;
                 /**
@@ -935,7 +935,7 @@ declare module 'process' {
                  * debugger. See `Signal Events`.
                  * @since v0.0.6
                  * @param pid A process ID
-                 * @param signal The signal to send, either as a string or number.
+                 * @param [signal='SIGTERM'] The signal to send, either as a string or number.
                  */
                 kill(pid: number, signal?: string | number): true;
                 /**
@@ -1165,8 +1165,8 @@ declare module 'process' {
                  * `process.umask()` returns the Node.js process's file mode creation mask. Child
                  * processes inherit the mask from the parent process.
                  * @since v0.1.19
-                 * @deprecated Deprecated. Calling `process.umask()` with no argument causes the process-wide umask to be written twice. This introduces a race condition between threads, and is a   *
-                 * potential security vulnerability. There is no safe, cross-platform alternative API.
+                 * @deprecated Calling `process.umask()` with no argument causes the process-wide umask to be written twice. This introduces a race condition between threads, and is a potential   *
+                 * security vulnerability. There is no safe, cross-platform alternative API.
                  */
                 umask(): number;
                 /**

node/querystring.d.ts

@@ -54,8 +54,8 @@ declare module 'querystring' {
      * ```
      * @since v0.1.25
      * @param obj The object to serialize into a URL query string
-     * @param sep The substring used to delimit key and value pairs in the query string.
-     * @param eq . The substring used to delimit keys and values in the query string.
+     * @param [sep='&'] The substring used to delimit key and value pairs in the query string.
+     * @param [eq='='] . The substring used to delimit keys and values in the query string.
      */
     function stringify(obj?: ParsedUrlQueryInput, sep?: string, eq?: string, options?: StringifyOptions): string;
     /**
@@ -87,8 +87,8 @@ declare module 'querystring' {
      * ```
      * @since v0.1.25
      * @param str The URL query string to parse
-     * @param sep The substring used to delimit key and value pairs in the query string.
-     * @param eq . The substring used to delimit keys and values in the query string.
+     * @param [sep='&'] The substring used to delimit key and value pairs in the query string.
+     * @param [eq='='] . The substring used to delimit keys and values in the query string.
      */
     function parse(str: string, sep?: string, eq?: string, options?: ParseOptions): ParsedUrlQuery;
     /**

node/stream.d.ts

@@ -587,7 +587,7 @@ declare module 'stream' {
              * @since v0.9.4
              * @param chunk Optional data to write. For streams not operating in object mode, `chunk` must be a string, `Buffer` or `Uint8Array`. For object mode streams, `chunk` may be any
              * JavaScript value other than `null`.
-             * @param encoding The encoding, if `chunk` is a string.
+             * @param [encoding='utf8'] The encoding, if `chunk` is a string.
              * @param callback Callback for when this chunk of data is flushed.
              * @return `false` if the stream wishes for the calling code to wait for the `'drain'` event to be emitted before continuing to write additional data; otherwise `true`.
              */

node/timers/promises.d.ts

@@ -42,7 +42,7 @@ declare module 'timers/promises' {
      * });
      * ```
      * @since v15.0.0
-     * @param delay The number of milliseconds to wait before fulfilling the promise.
+     * @param [delay=1] The number of milliseconds to wait before fulfilling the promise.
      * @param value A value with which the promise is fulfilled.
      */
     function setTimeout<T = void>(delay?: number, value?: T, options?: TimerOptions): Promise<T>;

node/tls.d.ts

@@ -127,8 +127,6 @@ declare module 'tls' {
         requestOCSP?: boolean | undefined;
     }
     /**
-     * * Extends: `<net.Socket>`
-     *
      * Performs transparent encryption of written data and all required TLS
      * negotiation.
      *
@@ -144,7 +142,9 @@ declare module 'tls' {
          */
         constructor(socket: net.Socket, options?: TLSSocketOptions);
         /**
-         * A boolean that is true if the peer certificate was signed by one of the specified CAs, otherwise false.
+         * Returns `true` if the peer certificate was signed by one of the CAs specified
+         * when creating the `tls.TLSSocket` instance, otherwise `false`.
+         * @since v0.11.4
          */
         authorized: boolean;
         /**
@@ -328,7 +328,7 @@ declare module 'tls' {
          * smaller fragments add extra TLS framing bytes and CPU overhead, which may
          * decrease overall server throughput.
          * @since v0.11.11
-         * @param size The maximum TLS fragment size. The maximum value is `16384`.
+         * @param [size=16384] The maximum TLS fragment size. The maximum value is `16384`.
          */
         setMaxSendFragment(size: number): boolean;
         /**
@@ -542,8 +542,6 @@ declare module 'tls' {
         pskCallback?(hint: string | null): PSKCallbackNegotation | null;
     }
     /**
-     * * Extends: `<net.Server>`
-     *
      * Accepts encrypted connections using TLS or SSL.
      * @since v0.3.2
      */