@types/node 16.4.7 → 16.4.11

node/README.md

@@ -8,9 +8,9 @@ This package contains type definitions for Node.js (http://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Thu, 29 Jul 2021 13:01:18 GMT
+ * Last updated: Wed, 04 Aug 2021 09:01:24 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`
 
 # Credits
-These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [DefinitelyTyped](https://github.com/DefinitelyTyped), [Alberto Schiabel](https://github.com/jkomyno), [Alvis HT Tang](https://github.com/alvis), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [Chigozirim C.](https://github.com/smac89), [David Junger](https://github.com/touffy), [Deividas Bakanas](https://github.com/DeividasBakanas), [Eugene Y. Q. Shen](https://github.com/eyqs), [Hannes Magnusson](https://github.com/Hannes-Magnusson-CK), [Hoàng Văn Khải](https://github.com/KSXGitHub), [Huw](https://github.com/hoo29), [Kelvin Jin](https://github.com/kjin), [Klaus Meinhardt](https://github.com/ajafff), [Lishude](https://github.com/islishude), [Mariusz Wiktorczyk](https://github.com/mwiktorczyk), [Mohsen Azimi](https://github.com/mohsen1), [Nicolas Even](https://github.com/n-e), [Nikita Galkin](https://github.com/galkin), [Parambir Singh](https://github.com/parambirs), [Sebastian Silbermann](https://github.com/eps1lon), [Simon Schick](https://github.com/SimonSchick), [Thomas den Hollander](https://github.com/ThomasdenH), [Wilco Bakker](https://github.com/WilcoBakker), [wwwy3y3](https://github.com/wwwy3y3), [Samuel Ainsworth](https://github.com/samuela), [Kyle Uehlein](https://github.com/kuehlein), [Thanik Bhongbhibhat](https://github.com/bhongy), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Minh Son Nguyen](https://github.com/nguymin4), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Surasak Chaisurin](https://github.com/Ryan-Willpower), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Jason Kwok](https://github.com/JasonHK), [Victor Perin](https://github.com/victorperin), [Yongsheng Zhang](https://github.com/ZYSzys), and [NodeJS Contributors](https://github.com/NodeJS).
+These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [DefinitelyTyped](https://github.com/DefinitelyTyped), [Alberto Schiabel](https://github.com/jkomyno), [Alvis HT Tang](https://github.com/alvis), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [Chigozirim C.](https://github.com/smac89), [David Junger](https://github.com/touffy), [Deividas Bakanas](https://github.com/DeividasBakanas), [Eugene Y. Q. Shen](https://github.com/eyqs), [Hannes Magnusson](https://github.com/Hannes-Magnusson-CK), [Hoàng Văn Khải](https://github.com/KSXGitHub), [Huw](https://github.com/hoo29), [Kelvin Jin](https://github.com/kjin), [Klaus Meinhardt](https://github.com/ajafff), [Lishude](https://github.com/islishude), [Mariusz Wiktorczyk](https://github.com/mwiktorczyk), [Mohsen Azimi](https://github.com/mohsen1), [Nicolas Even](https://github.com/n-e), [Nikita Galkin](https://github.com/galkin), [Parambir Singh](https://github.com/parambirs), [Sebastian Silbermann](https://github.com/eps1lon), [Simon Schick](https://github.com/SimonSchick), [Thomas den Hollander](https://github.com/ThomasdenH), [Wilco Bakker](https://github.com/WilcoBakker), [wwwy3y3](https://github.com/wwwy3y3), [Samuel Ainsworth](https://github.com/samuela), [Kyle Uehlein](https://github.com/kuehlein), [Thanik Bhongbhibhat](https://github.com/bhongy), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Minh Son Nguyen](https://github.com/nguymin4), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Surasak Chaisurin](https://github.com/Ryan-Willpower), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Jason Kwok](https://github.com/JasonHK), [Victor Perin](https://github.com/victorperin), [Yongsheng Zhang](https://github.com/ZYSzys), [NodeJS Contributors](https://github.com/NodeJS), and [Linus Unnebäck](https://github.com/LinusU).

node/assert.d.ts

@@ -72,6 +72,8 @@ declare module 'assert' {
              * const callsfunc = tracker.calls(func);
              * ```
              * @since v14.2.0, v12.19.0
+             * @param [fn='A no-op function']
+             * @param [exact=1]
              * @return that wraps `fn`.
              */
             calls(exact?: number): () => void;
@@ -228,6 +230,7 @@ declare module 'assert' {
          * Using `assert.fail()` with more than two arguments is possible but deprecated.
          * See below for further details.
          * @since v0.1.21
+         * @param [message='Failed']
          */
         function fail(message?: string | Error): never;
         /** @deprecated since v10.0.0 - use fail([message]) or other assert functions instead. */

node/buffer.d.ts

@@ -330,9 +330,9 @@ declare module 'buffer' {
              * ```
              * @since v0.1.90
              * @param string String to write to `buf`.
-             * @param offset Number of bytes to skip before starting to write `string`.
-             * @param length Maximum number of bytes to write (written bytes will not exceed `buf.length - offset`).
-             * @param encoding The character encoding of `string`.
+             * @param [offset=0] Number of bytes to skip before starting to write `string`.
+             * @param [length=buf.length - offset] Maximum number of bytes to write (written bytes will not exceed `buf.length - offset`).
+             * @param [encoding='utf8'] The character encoding of `string`.
              * @return Number of bytes written.
              */
             write(string: string, encoding?: BufferEncoding): number;
@@ -370,9 +370,9 @@ declare module 'buffer' {
              * // Prints: té
              * ```
              * @since v0.1.90
-             * @param encoding The character encoding to use.
-             * @param start The byte offset to start decoding at.
-             * @param end The byte offset to stop decoding at (not inclusive).
+             * @param [encoding='utf8'] The character encoding to use.
+             * @param [start=0] The byte offset to start decoding at.
+             * @param [end=buf.length] The byte offset to stop decoding at (not inclusive).
              */
             toString(encoding?: BufferEncoding, start?: number, end?: number): string;
             /**
@@ -466,10 +466,10 @@ declare module 'buffer' {
              * `ERR_OUT_OF_RANGE` is thrown if `targetStart < 0`, `sourceStart < 0`,`targetEnd > target.byteLength`, or `sourceEnd > source.byteLength`.
              * @since v0.11.13
              * @param target A `Buffer` or {@link Uint8Array} with which to compare `buf`.
-             * @param targetStart The offset within `target` at which to begin comparison.
-             * @param targetEnd The offset within `target` at which to end comparison (not inclusive).
-             * @param sourceStart The offset within `buf` at which to begin comparison.
-             * @param sourceEnd The offset within `buf` at which to end comparison (not inclusive).
+             * @param [targetStart=0] The offset within `target` at which to begin comparison.
+             * @param [targetEnd=target.length] The offset within `target` at which to end comparison (not inclusive).
+             * @param [sourceStart=0] The offset within `buf` at which to begin comparison.
+             * @param [sourceEnd=buf.length] The offset within `buf` at which to end comparison (not inclusive).
              */
             compare(target: Uint8Array, targetStart?: number, targetEnd?: number, sourceStart?: number, sourceEnd?: number): number;
             /**
@@ -516,9 +516,9 @@ declare module 'buffer' {
              * ```
              * @since v0.1.90
              * @param target A `Buffer` or {@link Uint8Array} to copy into.
-             * @param targetStart The offset within `target` at which to begin writing.
-             * @param sourceStart The offset within `buf` from which to begin copying.
-             * @param sourceEnd The offset within `buf` at which to stop copying (not inclusive).
+             * @param [targetStart=0] The offset within `target` at which to begin writing.
+             * @param [sourceStart=0] The offset within `buf` from which to begin copying.
+             * @param [sourceEnd=buf.length] The offset within `buf` at which to stop copying (not inclusive).
              * @return The number of bytes copied.
              */
             copy(target: Uint8Array, targetStart?: number, sourceStart?: number, sourceEnd?: number): number;
@@ -543,8 +543,8 @@ declare module 'buffer' {
              * // Prints: buffer
              * ```
              * @since v0.3.0
-             * @param start Where the new `Buffer` will start.
-             * @param end Where the new `Buffer` will end (not inclusive).
+             * @param [start=0] Where the new `Buffer` will start.
+             * @param [end=buf.length] Where the new `Buffer` will end (not inclusive).
              */
             slice(start?: number, end?: number): Buffer;
             /**
@@ -599,8 +599,8 @@ declare module 'buffer' {
              * // (Equivalent to buf.subarray(1, 4).)
              * ```
              * @since v3.0.0
-             * @param start Where the new `Buffer` will start.
-             * @param end Where the new `Buffer` will end (not inclusive).
+             * @param [start=0] Where the new `Buffer` will start.
+             * @param [end=buf.length] Where the new `Buffer` will end (not inclusive).
              */
             subarray(start?: number, end?: number): Buffer;
             /**
@@ -618,7 +618,7 @@ declare module 'buffer' {
              * ```
              * @since v12.0.0, v10.20.0
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
              * @return `offset` plus the number of bytes written.
              */
             writeBigInt64BE(value: bigint, offset?: number): number;
@@ -637,7 +637,7 @@ declare module 'buffer' {
              * ```
              * @since v12.0.0, v10.20.0
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
              * @return `offset` plus the number of bytes written.
              */
             writeBigInt64LE(value: bigint, offset?: number): number;
@@ -656,7 +656,7 @@ declare module 'buffer' {
              * ```
              * @since v12.0.0, v10.20.0
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
              * @return `offset` plus the number of bytes written.
              */
             writeBigUInt64BE(value: bigint, offset?: number): number;
@@ -675,7 +675,7 @@ declare module 'buffer' {
              * This function is also available under the `writeBigUint64LE` alias.
              * @since v12.0.0, v10.20.0
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
              * @return `offset` plus the number of bytes written.
              */
             writeBigUInt64LE(value: bigint, offset?: number): number;
@@ -771,7 +771,7 @@ declare module 'buffer' {
              * // Prints: 4294967295n
              * ```
              * @since v12.0.0, v10.20.0
-             * @param offset Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
              */
             readBigUInt64BE(offset?: number): bigint;
             /**
@@ -786,7 +786,7 @@ declare module 'buffer' {
              * // Prints: 18446744069414584320n
              * ```
              * @since v12.0.0, v10.20.0
-             * @param offset Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
              */
             readBigUInt64LE(offset?: number): bigint;
             /**
@@ -795,7 +795,7 @@ declare module 'buffer' {
              * Integers read from a `Buffer` are interpreted as two's complement signed
              * values.
              * @since v12.0.0, v10.20.0
-             * @param offset Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
              */
             readBigInt64BE(offset?: number): bigint;
             /**
@@ -804,7 +804,7 @@ declare module 'buffer' {
              * Integers read from a `Buffer` are interpreted as two's complement signed
              * values.
              * @since v12.0.0, v10.20.0
-             * @param offset Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
              */
             readBigInt64LE(offset?: number): bigint;
             /**
@@ -893,7 +893,7 @@ declare module 'buffer' {
              * // Throws ERR_OUT_OF_RANGE.
              * ```
              * @since v0.5.0
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 1`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 1`.
              */
             readUInt8(offset?: number): number;
             /**
@@ -912,7 +912,7 @@ declare module 'buffer' {
              * // Throws ERR_OUT_OF_RANGE.
              * ```
              * @since v0.5.5
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
              */
             readUInt16LE(offset?: number): number;
             /**
@@ -929,7 +929,7 @@ declare module 'buffer' {
              * // Prints: 3456
              * ```
              * @since v0.5.5
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
              */
             readUInt16BE(offset?: number): number;
             /**
@@ -946,7 +946,7 @@ declare module 'buffer' {
              * // Throws ERR_OUT_OF_RANGE.
              * ```
              * @since v0.5.5
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
              */
             readUInt32LE(offset?: number): number;
             /**
@@ -961,7 +961,7 @@ declare module 'buffer' {
              * // Prints: 12345678
              * ```
              * @since v0.5.5
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
              */
             readUInt32BE(offset?: number): number;
             /**
@@ -980,7 +980,7 @@ declare module 'buffer' {
              * // Throws ERR_OUT_OF_RANGE.
              * ```
              * @since v0.5.0
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 1`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 1`.
              */
             readInt8(offset?: number): number;
             /**
@@ -997,7 +997,7 @@ declare module 'buffer' {
              * // Throws ERR_OUT_OF_RANGE.
              * ```
              * @since v0.5.5
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
              */
             readInt16LE(offset?: number): number;
             /**
@@ -1012,7 +1012,7 @@ declare module 'buffer' {
              * // Prints: 5
              * ```
              * @since v0.5.5
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
              */
             readInt16BE(offset?: number): number;
             /**
@@ -1029,7 +1029,7 @@ declare module 'buffer' {
              * // Throws ERR_OUT_OF_RANGE.
              * ```
              * @since v0.5.5
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
              */
             readInt32LE(offset?: number): number;
             /**
@@ -1044,7 +1044,7 @@ declare module 'buffer' {
              * // Prints: 5
              * ```
              * @since v0.5.5
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
              */
             readInt32BE(offset?: number): number;
             /**
@@ -1059,7 +1059,7 @@ declare module 'buffer' {
              * // Throws ERR_OUT_OF_RANGE.
              * ```
              * @since v0.11.15
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
              */
             readFloatLE(offset?: number): number;
             /**
@@ -1072,7 +1072,7 @@ declare module 'buffer' {
              * // Prints: 2.387939260590663e-38
              * ```
              * @since v0.11.15
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
              */
             readFloatBE(offset?: number): number;
             /**
@@ -1087,7 +1087,7 @@ declare module 'buffer' {
              * // Throws ERR_OUT_OF_RANGE.
              * ```
              * @since v0.11.15
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 8`.
              */
             readDoubleLE(offset?: number): number;
             /**
@@ -1100,7 +1100,7 @@ declare module 'buffer' {
              * // Prints: 8.20788039913184e-304
              * ```
              * @since v0.11.15
-             * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 8`.
              */
             readDoubleBE(offset?: number): number;
             reverse(): this;
@@ -1204,7 +1204,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.0
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 1`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 1`.
              * @return `offset` plus the number of bytes written.
              */
             writeUInt8(value: number, offset?: number): number;
@@ -1225,7 +1225,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.5
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
              * @return `offset` plus the number of bytes written.
              */
             writeUInt16LE(value: number, offset?: number): number;
@@ -1246,7 +1246,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.5
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
              * @return `offset` plus the number of bytes written.
              */
             writeUInt16BE(value: number, offset?: number): number;
@@ -1266,7 +1266,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.5
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
              * @return `offset` plus the number of bytes written.
              */
             writeUInt32LE(value: number, offset?: number): number;
@@ -1286,7 +1286,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.5
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
              * @return `offset` plus the number of bytes written.
              */
             writeUInt32BE(value: number, offset?: number): number;
@@ -1308,7 +1308,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.0
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 1`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 1`.
              * @return `offset` plus the number of bytes written.
              */
             writeInt8(value: number, offset?: number): number;
@@ -1328,7 +1328,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.5
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
              * @return `offset` plus the number of bytes written.
              */
             writeInt16LE(value: number, offset?: number): number;
@@ -1348,7 +1348,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.5
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
              * @return `offset` plus the number of bytes written.
              */
             writeInt16BE(value: number, offset?: number): number;
@@ -1368,7 +1368,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.5
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
              * @return `offset` plus the number of bytes written.
              */
             writeInt32LE(value: number, offset?: number): number;
@@ -1388,7 +1388,7 @@ declare module 'buffer' {
              * ```
              * @since v0.5.5
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
              * @return `offset` plus the number of bytes written.
              */
             writeInt32BE(value: number, offset?: number): number;
@@ -1406,7 +1406,7 @@ declare module 'buffer' {
              * ```
              * @since v0.11.15
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
              * @return `offset` plus the number of bytes written.
              */
             writeFloatLE(value: number, offset?: number): number;
@@ -1424,7 +1424,7 @@ declare module 'buffer' {
              * ```
              * @since v0.11.15
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
              * @return `offset` plus the number of bytes written.
              */
             writeFloatBE(value: number, offset?: number): number;
@@ -1442,7 +1442,7 @@ declare module 'buffer' {
              * ```
              * @since v0.11.15
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 8`.
              * @return `offset` plus the number of bytes written.
              */
             writeDoubleLE(value: number, offset?: number): number;
@@ -1460,7 +1460,7 @@ declare module 'buffer' {
              * ```
              * @since v0.11.15
              * @param value Number to be written to `buf`.
-             * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 8`.
+             * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 8`.
              * @return `offset` plus the number of bytes written.
              */
             writeDoubleBE(value: number, offset?: number): number;
@@ -1506,9 +1506,9 @@ declare module 'buffer' {
              * ```
              * @since v0.5.0
              * @param value The value with which to fill `buf`.
-             * @param offset Number of bytes to skip before starting to fill `buf`.
-             * @param end Where to stop filling `buf` (not inclusive).
-             * @param encoding The encoding for `value` if `value` is a string.
+             * @param [offset=0] Number of bytes to skip before starting to fill `buf`.
+             * @param [end=buf.length] Where to stop filling `buf` (not inclusive).
+             * @param [encoding='utf8'] The encoding for `value` if `value` is a string.
              * @return A reference to `buf`.
              */
             fill(value: string | Uint8Array | number, offset?: number, end?: number, encoding?: BufferEncoding): this;
@@ -1572,8 +1572,8 @@ declare module 'buffer' {
              * than `buf.length`, `byteOffset` will be returned. If `value` is empty and`byteOffset` is at least `buf.length`, `buf.length` will be returned.
              * @since v1.5.0
              * @param value What to search for.
-             * @param byteOffset Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
-             * @param encoding If `value` is a string, this is the encoding used to determine the binary representation of the string that will be searched for in `buf`.
+             * @param [byteOffset=0] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
+             * @param [encoding='utf8'] If `value` is a string, this is the encoding used to determine the binary representation of the string that will be searched for in `buf`.
              * @return The index of the first occurrence of `value` in `buf`, or `-1` if `buf` does not contain `value`.
              */
             indexOf(value: string | number | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number;
@@ -1636,8 +1636,8 @@ declare module 'buffer' {
              * If `value` is an empty string or empty `Buffer`, `byteOffset` will be returned.
              * @since v6.0.0
              * @param value What to search for.
-             * @param byteOffset Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
-             * @param encoding If `value` is a string, this is the encoding used to determine the binary representation of the string that will be searched for in `buf`.
+             * @param [byteOffset=buf.length - 1] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
+             * @param [encoding='utf8'] If `value` is a string, this is the encoding used to determine the binary representation of the string that will be searched for in `buf`.
              * @return The index of the last occurrence of `value` in `buf`, or `-1` if `buf` does not contain `value`.
              */
             lastIndexOf(value: string | number | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number;
@@ -1687,8 +1687,8 @@ declare module 'buffer' {
              * ```
              * @since v5.3.0
              * @param value What to search for.
-             * @param byteOffset Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
-             * @param encoding If `value` is a string, this is its encoding.
+             * @param [byteOffset=0] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
+             * @param [encoding='utf8'] If `value` is a string, this is its encoding.
              * @return `true` if `value` was found in `buf`, `false` otherwise.
              */
             includes(value: string | number | Buffer, byteOffset?: number, encoding?: BufferEncoding): boolean;

node/cluster.d.ts

@@ -137,7 +137,7 @@ declare module 'cluster' {
          * In a worker, `process.kill()` exists, but it is not this function;
          * it is `kill()`.
          * @since v0.9.12
-         * @param signal Name of the kill signal to send to the worker process.
+         * @param [signal='SIGTERM'] Name of the kill signal to send to the worker process.
          */
         kill(signal?: string): void;
         destroy(signal?: string): void;

node/crypto.d.ts

@@ -1133,6 +1133,7 @@ declare module 'crypto' {
          *
          * The `cipher.setAutoPadding()` method must be called before `cipher.final()`.
          * @since v0.7.1
+         * @param [autoPadding=true]
          * @return for method chaining.
          */
         setAutoPadding(autoPadding?: boolean): this;
@@ -1441,6 +1442,7 @@ declare module 'crypto' {
          *
          * The `decipher.setAutoPadding()` method must be called before `decipher.final()`.
          * @since v0.7.1
+         * @param [autoPadding=true]
          * @return for method chaining.
          */
         setAutoPadding(auto_padding?: boolean): this;
@@ -1790,6 +1792,7 @@ declare module 'crypto' {
      * otherwise a number, `Buffer`, `TypedArray`, or `DataView` is expected.
      * @since v0.11.12
      * @param primeEncoding The `encoding` of the `prime` string.
+     * @param [generator=2]
      * @param generatorEncoding The `encoding` of the `generator` string.
      */
     function createDiffieHellman(primeLength: number, generator?: number | NodeJS.ArrayBufferView): DiffieHellman;
@@ -2279,7 +2282,7 @@ declare module 'crypto' {
      * console.log(`The dice rolled: ${n}`);
      * ```
      * @since v14.10.0, v12.19.0
-     * @param min Start of random range (inclusive).
+     * @param [min=0] Start of random range (inclusive).
      * @param max End of random range (exclusive).
      * @param callback `function(err, n) {}`.
      */
@@ -2359,6 +2362,8 @@ declare module 'crypto' {
      * ```
      * @since v7.10.0, v6.13.0
      * @param buffer Must be supplied. The size of the provided `buffer` must not be larger than `2**31 - 1`.
+     * @param [offset=0]
+     * @param [size=buffer.length - offset]
      * @return The object passed as `buffer` argument.
      */
     function randomFillSync<T extends NodeJS.ArrayBufferView>(buffer: T, offset?: number, size?: number): T;
@@ -2484,6 +2489,8 @@ declare module 'crypto' {
      * request.
      * @since v7.10.0, v6.13.0
      * @param buffer Must be supplied. The size of the provided `buffer` must not be larger than `2**31 - 1`.
+     * @param [offset=0]
+     * @param [size=buffer.length - offset]
      * @param callback `function(err, buf) {}`.
      */
     function randomFill<T extends NodeJS.ArrayBufferView>(buffer: T, callback: (err: Error | null, buf: T) => void): void;
@@ -2832,6 +2839,7 @@ declare module 'crypto' {
          * @since v10.0.0
          * @param inputEncoding The `encoding` of the `key` string.
          * @param outputEncoding The `encoding` of the return value.
+         * @param [format='uncompressed']
          */
         static convertKey(
             key: BinaryLike,
@@ -2850,6 +2858,7 @@ declare module 'crypto' {
          * If `encoding` is provided a string is returned; otherwise a `Buffer` is returned.
          * @since v0.11.14
          * @param encoding The `encoding` of the return value.
+         * @param [format='uncompressed']
          */
         generateKeys(): Buffer;
         generateKeys(encoding: BinaryToTextEncoding, format?: ECDHKeyFormat): string;
@@ -2890,6 +2899,7 @@ declare module 'crypto' {
          * returned.
          * @since v0.11.14
          * @param encoding The `encoding` of the return value.
+         * @param [format='uncompressed']
          * @return The EC Diffie-Hellman public key in the specified `encoding` and `format`.
          */
         getPublicKey(): Buffer;

node/dns/promises.d.ts

@@ -122,7 +122,7 @@ declare module 'dns/promises' {
      * On error, the `Promise` is rejected with an `Error` object, where `err.code`is one of the `DNS error codes`.
      * @since v10.6.0
      * @param hostname Host name to resolve.
-     * @param rrtype Resource record type.
+     * @param [rrtype='A'] Resource record type.
      */
     function resolve(hostname: string): Promise<string[]>;
     function resolve(hostname: string, rrtype: 'A'): Promise<string[]>;

node/dns.d.ts

@@ -244,7 +244,7 @@ declare module 'dns' {
      * On error, `err` is an `Error` object, where `err.code` is one of the `DNS error codes`.
      * @since v0.1.27
      * @param hostname Host name to resolve.
-     * @param rrtype Resource record type.
+     * @param [rrtype='A'] Resource record type.
      */
     export function resolve(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
     export function resolve(hostname: string, rrtype: 'A', callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
@@ -626,8 +626,8 @@ declare module 'dns' {
          * servers, and the v6 local address when making requests to IPv6 DNS servers.
          * The `rrtype` of resolution requests has no impact on the local address used.
          * @since v15.1.0
-         * @param ipv4 A string representation of an IPv4 address.
-         * @param ipv6 A string representation of an IPv6 address.
+         * @param [ipv4='0.0.0.0'] A string representation of an IPv4 address.
+         * @param [ipv6='::0'] A string representation of an IPv6 address.
          */
         setLocalAddress(ipv4?: string, ipv6?: string): void;
         setServers: typeof setServers;

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

@@ -516,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;
     /**
@@ -538,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;
     /**
@@ -581,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;
     /**
@@ -602,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;
     /**
@@ -1952,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;
     /**
@@ -1974,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;
     /**
@@ -2196,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.
      */
@@ -2347,7 +2354,7 @@ declare module 'fs' {
                   encoding: BufferEncoding;
                   flag?: string | undefined;
               } & Abortable)
-            | string,
+            | BufferEncoding,
         callback: (err: NodeJS.ErrnoException | null, data: string) => void
     ): void;
     /**
@@ -2363,7 +2370,7 @@ declare module 'fs' {
             | (ObjectEncodingOptions & {
                   flag?: string | undefined;
               } & Abortable)
-            | string
+            | BufferEncoding
             | undefined
             | null,
         callback: (err: NodeJS.ErrnoException | null, data: string | Buffer) => void
@@ -2404,7 +2411,7 @@ declare module 'fs' {
                       encoding: BufferEncoding;
                       flag?: string | undefined;
                   }
-                | string
+                | BufferEncoding
         ): Promise<string>;
         /**
          * Asynchronously reads the entire contents of a file.
@@ -2420,7 +2427,7 @@ declare module 'fs' {
                 | (ObjectEncodingOptions & {
                       flag?: string | undefined;
                   })
-                | string
+                | BufferEncoding
                 | null
         ): Promise<string | Buffer>;
     }
@@ -2493,7 +2500,7 @@ declare module 'fs' {
                   mode?: Mode | undefined;
                   flag?: string | undefined;
               })
-        | string
+        | BufferEncoding
         | null;
     /**
      * When `file` is a filename, asynchronously writes data to the file, replacing the
@@ -2803,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,
@@ -3268,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;
     /**
@@ -3305,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 {
@@ -3387,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
@@ -3415,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
@@ -3474,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;
@@ -3513,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/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;

node/index.d.ts

@@ -42,6 +42,7 @@
 //                 Victor Perin <https://github.com/victorperin>
 //                 Yongsheng Zhang <https://github.com/ZYSzys>
 //                 NodeJS Contributors <https://github.com/NodeJS>
+//                 Linus Unnebäck <https://github.com/LinusU>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 /**

node/net.d.ts

@@ -87,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;
@@ -165,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;
@@ -183,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;
@@ -280,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.
          */
@@ -306,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;
@@ -315,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;
@@ -324,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;
@@ -333,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;
@@ -342,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;
@@ -351,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 {
@@ -558,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;
@@ -567,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;
@@ -576,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;
@@ -599,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.7",
+    "version": "16.4.11",
     "description": "TypeScript definitions for Node.js",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -214,6 +214,11 @@
             "name": "NodeJS Contributors",
             "url": "https://github.com/NodeJS",
             "githubUsername": "NodeJS"
+        },
+        {
+            "name": "Linus Unnebäck",
+            "url": "https://github.com/LinusU",
+            "githubUsername": "LinusU"
         }
     ],
     "main": "",
@@ -232,6 +237,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "15db94446f7f1e160948be1b1ecb14684eef4f4a29dc0fd41a570f2f071209d1",
+    "typesPublisherContentHash": "893f047790f417f590b7efe0927ac74b4ba3c14be787d1ec6ba9476effb7c83c",
     "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;
                 /**

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

@@ -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;
         /**

node/tty.d.ts

@@ -149,7 +149,7 @@ declare module 'tty' {
          *
          * Disabling color support is also possible by using the `NO_COLOR` and`NODE_DISABLE_COLORS` environment variables.
          * @since v9.9.0
-         * @param env An object containing the environment variables to check. This enables simulating the usage of a specific terminal.
+         * @param [env=process.env] An object containing the environment variables to check. This enables simulating the usage of a specific terminal.
          */
         getColorDepth(env?: object): number;
         /**
@@ -169,8 +169,8 @@ declare module 'tty' {
          * // Returns false (the environment setting pretends to support 2 ** 8 colors).
          * ```
          * @since v11.13.0, v10.16.0
-         * @param count The number of colors that are requested (minimum 2).
-         * @param env An object containing the environment variables to check. This enables simulating the usage of a specific terminal.
+         * @param [count=16] The number of colors that are requested (minimum 2).
+         * @param [env=process.env] An object containing the environment variables to check. This enables simulating the usage of a specific terminal.
          */
         hasColors(count?: number): boolean;
         hasColors(env?: object): boolean;

node/url.d.ts

@@ -65,10 +65,10 @@ declare module 'url' {
      * @since v0.1.25
      * @deprecated Legacy: Use the WHATWG URL API instead.
      * @param urlString The URL string to parse.
-     * @param parseQueryString If `true`, the `query` property will always be set to an object returned by the {@link querystring} module's `parse()` method. If `false`, the `query` property on the
-     * returned URL object will be an unparsed, undecoded string.
-     * @param slashesDenoteHost If `true`, the first token after the literal string `//` and preceding the next `/` will be interpreted as the `host`. For instance, given `//foo/bar`, the result
-     * would be `{host: 'foo', pathname: '/bar'}` rather than `{pathname: '//foo/bar'}`.
+     * @param [parseQueryString=false] If `true`, the `query` property will always be set to an object returned by the {@link querystring} module's `parse()` method. If `false`, the `query` property
+     * on the returned URL object will be an unparsed, undecoded string.
+     * @param [slashesDenoteHost=false] If `true`, the first token after the literal string `//` and preceding the next `/` will be interpreted as the `host`. For instance, given `//foo/bar`, the
+     * result would be `{host: 'foo', pathname: '/bar'}` rather than `{pathname: '//foo/bar'}`.
      */
     function parse(urlString: string): UrlWithStringQuery;
     function parse(urlString: string, parseQueryString: false | undefined, slashesDenoteHost?: boolean): UrlWithStringQuery;

node/util.d.ts

@@ -1038,7 +1038,7 @@ declare module 'util' {
         /**
          * UTF-8 encodes the `input` string and returns a `Uint8Array` containing the
          * encoded bytes.
-         * @param input The text to encode.
+         * @param [input='an empty string'] The text to encode.
          */
         encode(input?: string): Uint8Array;
         /**