@types/node 18.11.5 → 20.2.5

node/buffer.d.ts

@@ -10,7 +10,7 @@
  * recommended to explicitly reference it via an import or require statement.
  *
  * ```js
- * import { Buffer } from 'buffer';
+ * import { Buffer } from 'node:buffer';
  *
  * // Creates a zero-filled Buffer of length 10.
  * const buf1 = Buffer.alloc(10);
@@ -41,11 +41,29 @@
  * // Creates a Buffer containing the Latin-1 bytes [0x74, 0xe9, 0x73, 0x74].
  * const buf7 = Buffer.from('tést', 'latin1');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/buffer.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/buffer.js)
  */
 declare module 'buffer' {
     import { BinaryLike } from 'node:crypto';
     import { ReadableStream as WebReadableStream } from 'node:stream/web';
+    /**
+     * This function returns `true` if `input` contains only valid UTF-8-encoded data,
+     * including the case in which `input` is empty.
+     *
+     * Throws if the `input` is a detached array buffer.
+     * @since v19.4.0, v18.14.0
+     * @param input The input to validate.
+     */
+    export function isUtf8(input: Buffer | ArrayBuffer | NodeJS.TypedArray): boolean;
+    /**
+     * This function returns `true` if `input` contains only valid ASCII-encoded data,
+     * including the case in which `input` is empty.
+     *
+     * Throws if the `input` is a detached array buffer.
+     * @since v19.6.0, v18.15.0
+     * @param input The input to validate.
+     */
+    export function isAscii(input: Buffer | ArrayBuffer | NodeJS.TypedArray): boolean;
     export const INSPECT_MAX_BYTES: number;
     export const kMaxLength: number;
     export const kStringMaxLength: number;
@@ -67,7 +85,7 @@ declare module 'buffer' {
      * sequence cannot be adequately represented in the target encoding. For instance:
      *
      * ```js
-     * import { Buffer, transcode } from 'buffer';
+     * import { Buffer, transcode } from 'node:buffer';
      *
      * const newBuf = transcode(Buffer.from('€'), 'utf8', 'ascii');
      * console.log(newBuf.toString('ascii'));
@@ -158,22 +176,62 @@ declare module 'buffer' {
          */
         text(): Promise<string>;
         /**
-         * Returns a new (WHATWG) `ReadableStream` that allows the content of the `Blob` to be read.
+         * Returns a new `ReadableStream` that allows the content of the `Blob` to be read.
          * @since v16.7.0
          */
         stream(): WebReadableStream;
     }
+    export interface FileOptions {
+        /**
+         * One of either `'transparent'` or `'native'`. When set to `'native'`, line endings in string source parts will be
+         * converted to the platform native line-ending as specified by `require('node:os').EOL`.
+         */
+        endings?: 'native' | 'transparent';
+        /** The File content-type. */
+        type?: string;
+        /** The last modified date of the file. `Default`: Date.now(). */
+        lastModified?: number;
+    }
+    /**
+     * A [`File`](https://developer.mozilla.org/en-US/docs/Web/API/File) provides information about files.
+     * @since v19.2.0, v18.13.0
+     */
+    export class File extends Blob {
+        constructor(sources: Array<BinaryLike | Blob>, fileName: string, options?: FileOptions);
+        /**
+         * The name of the `File`.
+         * @since v19.2.0, v18.13.0
+         */
+        readonly name: string;
+        /**
+         * The last modified date of the `File`.
+         * @since v19.2.0, v18.13.0
+         */
+        readonly lastModified: number;
+    }
     export import atob = globalThis.atob;
     export import btoa = globalThis.btoa;
-
     import { Blob as NodeBlob } from 'buffer';
     // This conditional type will be the existing global Blob in a browser, or
     // the copy below in a Node environment.
-    type __Blob = typeof globalThis extends { onmessage: any, Blob: infer T }
-        ? T : NodeBlob;
+    type __Blob = typeof globalThis extends { onmessage: any; Blob: infer T } ? T : NodeBlob;
     global {
+        namespace NodeJS {
+            export { BufferEncoding };
+        }
         // Buffer class
-        type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
+        type BufferEncoding =
+            | 'ascii'
+            | 'utf8'
+            | 'utf-8'
+            | 'utf16le'
+            | 'ucs2'
+            | 'ucs-2'
+            | 'base64'
+            | 'base64url'
+            | 'latin1'
+            | 'binary'
+            | 'hex';
         type WithImplicitCoercion<T> =
             | T
             | {
@@ -235,7 +293,7 @@ declare module 'buffer' {
              * Array entries outside that range will be truncated to fit into it.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Creates a new Buffer containing the UTF-8 bytes of the string 'buffer'.
              * const buf = Buffer.from([0x62, 0x75, 0x66, 0x66, 0x65, 0x72]);
@@ -247,7 +305,11 @@ declare module 'buffer' {
              * `Buffer.from(array)` and `Buffer.from(string)` may also use the internal`Buffer` pool like `Buffer.allocUnsafe()` does.
              * @since v5.10.0
              */
-            from(arrayBuffer: WithImplicitCoercion<ArrayBuffer | SharedArrayBuffer>, byteOffset?: number, length?: number): Buffer;
+            from(
+                arrayBuffer: WithImplicitCoercion<ArrayBuffer | SharedArrayBuffer>,
+                byteOffset?: number,
+                length?: number,
+            ): Buffer;
             /**
              * Creates a new Buffer using the passed {data}
              * @param data data to create a new Buffer
@@ -265,7 +327,7 @@ declare module 'buffer' {
                     | {
                           [Symbol.toPrimitive](hint: 'string'): string;
                       },
-                encoding?: BufferEncoding
+                encoding?: BufferEncoding,
             ): Buffer;
             /**
              * Creates a new Buffer using the passed {data}
@@ -276,7 +338,7 @@ declare module 'buffer' {
              * Returns `true` if `obj` is a `Buffer`, `false` otherwise.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * Buffer.isBuffer(Buffer.alloc(10)); // true
              * Buffer.isBuffer(Buffer.from('foo')); // true
@@ -292,7 +354,7 @@ declare module 'buffer' {
              * or `false` otherwise.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * console.log(Buffer.isEncoding('utf8'));
              * // Prints: true
@@ -321,7 +383,7 @@ declare module 'buffer' {
              * string.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const str = '\u00bd + \u00bc = \u00be';
              *
@@ -339,7 +401,10 @@ declare module 'buffer' {
              * @param [encoding='utf8'] If `string` is a string, this is its encoding.
              * @return The number of bytes contained within `string`.
              */
-            byteLength(string: string | NodeJS.ArrayBufferView | ArrayBuffer | SharedArrayBuffer, encoding?: BufferEncoding): number;
+            byteLength(
+                string: string | NodeJS.ArrayBufferView | ArrayBuffer | SharedArrayBuffer,
+                encoding?: BufferEncoding,
+            ): number;
             /**
              * Returns a new `Buffer` which is the result of concatenating all the `Buffer`instances in the `list` together.
              *
@@ -353,7 +418,7 @@ declare module 'buffer' {
              * truncated to `totalLength`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Create a single `Buffer` from a list of three `Buffer` instances.
              *
@@ -379,11 +444,28 @@ declare module 'buffer' {
              * @param totalLength Total length of the `Buffer` instances in `list` when concatenated.
              */
             concat(list: ReadonlyArray<Uint8Array>, totalLength?: number): Buffer;
+            /**
+             * Copies the underlying memory of `view` into a new `Buffer`.
+             *
+             * ```js
+             * const u16 = new Uint16Array([0, 0xffff]);
+             * const buf = Buffer.copyBytesFrom(u16, 1, 1);
+             * u16[1] = 0;
+             * console.log(buf.length); // 2
+             * console.log(buf[0]); // 255
+             * console.log(buf[1]); // 255
+             * ```
+             * @since v19.8.0
+             * @param view The {TypedArray} to copy.
+             * @param [offset=': 0'] The starting offset within `view`.
+             * @param [length=view.length - offset] The number of elements from `view` to copy.
+             */
+            copyBytesFrom(view: NodeJS.TypedArray, offset?: number, length?: number): Buffer;
             /**
              * Compares `buf1` to `buf2`, typically for the purpose of sorting arrays of`Buffer` instances. This is equivalent to calling `buf1.compare(buf2)`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf1 = Buffer.from('1234');
              * const buf2 = Buffer.from('0123');
@@ -401,7 +483,7 @@ declare module 'buffer' {
              * Allocates a new `Buffer` of `size` bytes. If `fill` is `undefined`, the`Buffer` will be zero-filled.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.alloc(5);
              *
@@ -409,12 +491,12 @@ declare module 'buffer' {
              * // Prints: <Buffer 00 00 00 00 00>
              * ```
              *
-             * If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_INVALID_ARG_VALUE` is thrown.
+             * If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_OUT_OF_RANGE` is thrown.
              *
              * If `fill` is specified, the allocated `Buffer` will be initialized by calling `buf.fill(fill)`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.alloc(5, 'a');
              *
@@ -426,7 +508,7 @@ declare module 'buffer' {
              * initialized by calling `buf.fill(fill, encoding)`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64');
              *
@@ -446,13 +528,13 @@ declare module 'buffer' {
              */
             alloc(size: number, fill?: string | Buffer | number, encoding?: BufferEncoding): Buffer;
             /**
-             * Allocates a new `Buffer` of `size` bytes. If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_INVALID_ARG_VALUE` is thrown.
+             * Allocates a new `Buffer` of `size` bytes. If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_OUT_OF_RANGE` is thrown.
              *
              * The underlying memory for `Buffer` instances created in this way is _not_
              * _initialized_. The contents of the newly created `Buffer` are unknown and _may contain sensitive data_. Use `Buffer.alloc()` instead to initialize`Buffer` instances with zeroes.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(10);
              *
@@ -483,15 +565,15 @@ declare module 'buffer' {
              */
             allocUnsafe(size: number): Buffer;
             /**
-             * Allocates a new `Buffer` of `size` bytes. If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_INVALID_ARG_VALUE` is thrown. A zero-length `Buffer` is created
-             * if `size` is 0.
+             * Allocates a new `Buffer` of `size` bytes. If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_OUT_OF_RANGE` is thrown. A zero-length `Buffer` is created if
+             * `size` is 0.
              *
              * The underlying memory for `Buffer` instances created in this way is _not_
              * _initialized_. The contents of the newly created `Buffer` are unknown and _may contain sensitive data_. Use `buf.fill(0)` to initialize
              * such `Buffer` instances with zeroes.
              *
              * When using `Buffer.allocUnsafe()` to allocate new `Buffer` instances,
-             * allocations under 4 KB are sliced from a single pre-allocated `Buffer`. This
+             * allocations under 4 KiB are sliced from a single pre-allocated `Buffer`. This
              * allows applications to avoid the garbage collection overhead of creating many
              * individually allocated `Buffer` instances. This approach improves both
              * performance and memory usage by eliminating the need to track and clean up as
@@ -503,7 +585,7 @@ declare module 'buffer' {
              * then copying out the relevant bits.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Need to keep around a few small chunks of memory.
              * const store = [];
@@ -541,7 +623,7 @@ declare module 'buffer' {
              * written. However, partially encoded characters will not be written.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.alloc(256);
              *
@@ -577,7 +659,7 @@ declare module 'buffer' {
              * as {@link constants.MAX_STRING_LENGTH}.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf1 = Buffer.allocUnsafe(26);
              *
@@ -614,7 +696,7 @@ declare module 'buffer' {
              * In particular, `Buffer.from(buf.toJSON())` works like `Buffer.from(buf)`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5]);
              * const json = JSON.stringify(buf);
@@ -641,7 +723,7 @@ declare module 'buffer' {
              * Returns `true` if both `buf` and `otherBuffer` have exactly the same bytes,`false` otherwise. Equivalent to `buf.compare(otherBuffer) === 0`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf1 = Buffer.from('ABC');
              * const buf2 = Buffer.from('414243', 'hex');
@@ -665,7 +747,7 @@ declare module 'buffer' {
              * * `-1` is returned if `target` should come _after_`buf` when sorted.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf1 = Buffer.from('ABC');
              * const buf2 = Buffer.from('BCD');
@@ -689,7 +771,7 @@ declare module 'buffer' {
              * The optional `targetStart`, `targetEnd`, `sourceStart`, and `sourceEnd`arguments can be used to limit the comparison to specific ranges within `target`and `buf` respectively.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf1 = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8, 9]);
              * const buf2 = Buffer.from([5, 6, 7, 8, 9, 1, 2, 3, 4]);
@@ -710,7 +792,13 @@ declare module 'buffer' {
              * @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): -1 | 0 | 1;
+            compare(
+                target: Uint8Array,
+                targetStart?: number,
+                targetEnd?: number,
+                sourceStart?: number,
+                sourceEnd?: number,
+            ): -1 | 0 | 1;
             /**
              * Copies data from a region of `buf` to a region in `target`, even if the `target`memory region overlaps with `buf`.
              *
@@ -719,7 +807,7 @@ declare module 'buffer' {
              * different function arguments.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Create two `Buffer` instances.
              * const buf1 = Buffer.allocUnsafe(26);
@@ -740,7 +828,7 @@ declare module 'buffer' {
              * ```
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Create a `Buffer` and copy data from one region to an overlapping region
              * // within the same `Buffer`.
@@ -773,7 +861,7 @@ declare module 'buffer' {
              * which is a superclass of `Buffer`. To copy the slice, use`Uint8Array.prototype.slice()`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from('buffer');
              *
@@ -811,7 +899,7 @@ declare module 'buffer' {
              * Modifying the new `Buffer` slice will modify the memory in the original `Buffer`because the allocated memory of the two objects overlap.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Create a `Buffer` with the ASCII alphabet, take a slice, and modify one byte
              * // from the original `Buffer`.
@@ -838,7 +926,7 @@ declare module 'buffer' {
              * end of `buf` rather than the beginning.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from('buffer');
              *
@@ -865,7 +953,7 @@ declare module 'buffer' {
              * `value` is interpreted and written as a two's complement signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(8);
              *
@@ -886,7 +974,7 @@ declare module 'buffer' {
              * `value` is interpreted and written as a two's complement signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(8);
              *
@@ -907,7 +995,7 @@ declare module 'buffer' {
              * This function is also available under the `writeBigUint64BE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(8);
              *
@@ -931,7 +1019,7 @@ declare module 'buffer' {
              * Writes `value` to `buf` at the specified `offset` as little-endian
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(8);
              *
@@ -960,7 +1048,7 @@ declare module 'buffer' {
              * This function is also available under the `writeUintLE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(6);
              *
@@ -988,7 +1076,7 @@ declare module 'buffer' {
              * This function is also available under the `writeUintBE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(6);
              *
@@ -1014,7 +1102,7 @@ declare module 'buffer' {
              * when `value` is anything other than a signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(6);
              *
@@ -1035,7 +1123,7 @@ declare module 'buffer' {
              * signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(6);
              *
@@ -1057,7 +1145,7 @@ declare module 'buffer' {
              * This function is also available under the `readBigUint64BE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
              *
@@ -1079,7 +1167,7 @@ declare module 'buffer' {
              * This function is also available under the `readBigUint64LE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
              *
@@ -1120,7 +1208,7 @@ declare module 'buffer' {
              * This function is also available under the `readUintLE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
              *
@@ -1144,7 +1232,7 @@ declare module 'buffer' {
              * This function is also available under the `readUintBE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
              *
@@ -1168,7 +1256,7 @@ declare module 'buffer' {
              * supporting up to 48 bits of accuracy.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
              *
@@ -1185,7 +1273,7 @@ declare module 'buffer' {
              * supporting up to 48 bits of accuracy.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
              *
@@ -1207,7 +1295,7 @@ declare module 'buffer' {
              * This function is also available under the `readUint8` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([1, -2]);
              *
@@ -1233,7 +1321,7 @@ declare module 'buffer' {
              * This function is also available under the `readUint16LE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x12, 0x34, 0x56]);
              *
@@ -1259,7 +1347,7 @@ declare module 'buffer' {
              * This function is also available under the `readUint16BE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x12, 0x34, 0x56]);
              *
@@ -1283,7 +1371,7 @@ declare module 'buffer' {
              * This function is also available under the `readUint32LE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78]);
              *
@@ -1307,7 +1395,7 @@ declare module 'buffer' {
              * This function is also available under the `readUint32BE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78]);
              *
@@ -1329,7 +1417,7 @@ declare module 'buffer' {
              * Integers read from a `Buffer` are interpreted as two's complement signed values.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([-1, 5]);
              *
@@ -1350,7 +1438,7 @@ declare module 'buffer' {
              * Integers read from a `Buffer` are interpreted as two's complement signed values.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0, 5]);
              *
@@ -1369,7 +1457,7 @@ declare module 'buffer' {
              * Integers read from a `Buffer` are interpreted as two's complement signed values.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0, 5]);
              *
@@ -1386,7 +1474,7 @@ declare module 'buffer' {
              * Integers read from a `Buffer` are interpreted as two's complement signed values.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0, 0, 0, 5]);
              *
@@ -1405,7 +1493,7 @@ declare module 'buffer' {
              * Integers read from a `Buffer` are interpreted as two's complement signed values.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([0, 0, 0, 5]);
              *
@@ -1420,7 +1508,7 @@ declare module 'buffer' {
              * Reads a 32-bit, little-endian float from `buf` at the specified `offset`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([1, 2, 3, 4]);
              *
@@ -1437,7 +1525,7 @@ declare module 'buffer' {
              * Reads a 32-bit, big-endian float from `buf` at the specified `offset`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([1, 2, 3, 4]);
              *
@@ -1452,7 +1540,7 @@ declare module 'buffer' {
              * Reads a 64-bit, little-endian double from `buf` at the specified `offset`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
              *
@@ -1469,7 +1557,7 @@ declare module 'buffer' {
              * Reads a 64-bit, big-endian double from `buf` at the specified `offset`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
              *
@@ -1486,7 +1574,7 @@ declare module 'buffer' {
              * byte order _in-place_. Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 2.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
              *
@@ -1508,7 +1596,7 @@ declare module 'buffer' {
              * between UTF-16 little-endian and UTF-16 big-endian:
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from('This is little-endian UTF-16', 'utf16le');
              * buf.swap16(); // Convert to big-endian UTF-16 text.
@@ -1522,7 +1610,7 @@ declare module 'buffer' {
              * byte order _in-place_. Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 4.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
              *
@@ -1548,7 +1636,7 @@ declare module 'buffer' {
              * Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 8.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
              *
@@ -1577,7 +1665,7 @@ declare module 'buffer' {
              * This function is also available under the `writeUint8` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1607,7 +1695,7 @@ declare module 'buffer' {
              * This function is also available under the `writeUint16LE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1635,7 +1723,7 @@ declare module 'buffer' {
              * This function is also available under the `writeUint16BE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1663,7 +1751,7 @@ declare module 'buffer' {
              * This function is also available under the `writeUint32LE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1690,7 +1778,7 @@ declare module 'buffer' {
              * This function is also available under the `writeUint32BE` alias.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1718,7 +1806,7 @@ declare module 'buffer' {
              * `value` is interpreted and written as a two's complement signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(2);
              *
@@ -1741,7 +1829,7 @@ declare module 'buffer' {
              * The `value` is interpreted and written as a two's complement signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(2);
              *
@@ -1763,7 +1851,7 @@ declare module 'buffer' {
              * The `value` is interpreted and written as a two's complement signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(2);
              *
@@ -1785,7 +1873,7 @@ declare module 'buffer' {
              * The `value` is interpreted and written as a two's complement signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1807,7 +1895,7 @@ declare module 'buffer' {
              * The `value` is interpreted and written as a two's complement signed integer.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1827,7 +1915,7 @@ declare module 'buffer' {
              * undefined when `value` is anything other than a JavaScript number.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1847,7 +1935,7 @@ declare module 'buffer' {
              * undefined when `value` is anything other than a JavaScript number.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(4);
              *
@@ -1867,7 +1955,7 @@ declare module 'buffer' {
              * other than a JavaScript number.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(8);
              *
@@ -1887,7 +1975,7 @@ declare module 'buffer' {
              * other than a JavaScript number.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(8);
              *
@@ -1907,7 +1995,7 @@ declare module 'buffer' {
              * the entire `buf` will be filled:
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Fill a `Buffer` with the ASCII character 'h'.
              *
@@ -1915,6 +2003,12 @@ declare module 'buffer' {
              *
              * console.log(b.toString());
              * // Prints: hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh
+             *
+             * // Fill a buffer with empty string
+             * const c = Buffer.allocUnsafe(5).fill('');
+             *
+             * console.log(c.fill(''));
+             * // Prints: <Buffer 00 00 00 00 00>
              * ```
              *
              * `value` is coerced to a `uint32` value if it is not a string, `Buffer`, or
@@ -1925,7 +2019,7 @@ declare module 'buffer' {
              * then only the bytes of that character that fit into `buf` are written:
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Fill a `Buffer` with character that takes up two bytes in UTF-8.
              *
@@ -1937,7 +2031,7 @@ declare module 'buffer' {
              * fill data remains, an exception is thrown:
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.allocUnsafe(5);
              *
@@ -1949,7 +2043,7 @@ declare module 'buffer' {
              * // Throws an exception.
              * ```
              * @since v0.5.0
-             * @param value The value with which to fill `buf`.
+             * @param value The value with which to fill `buf`. Empty value (string, Uint8Array, Buffer) is coerced to `0`.
              * @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.
@@ -1966,7 +2060,7 @@ declare module 'buffer' {
              * value between `0` and `255`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from('this is a buffer');
              *
@@ -1999,7 +2093,7 @@ declare module 'buffer' {
              * behavior matches [`String.prototype.indexOf()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf).
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const b = Buffer.from('abcdef');
              *
@@ -2030,7 +2124,7 @@ declare module 'buffer' {
              * rather than the first occurrence.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from('this buffer is a buffer');
              *
@@ -2065,7 +2159,7 @@ declare module 'buffer' {
              * This behavior matches [`String.prototype.lastIndexOf()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/lastIndexOf).
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const b = Buffer.from('abcdef');
              *
@@ -2098,7 +2192,7 @@ declare module 'buffer' {
              * of `buf`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * // Log the entire contents of a `Buffer`.
              *
@@ -2122,7 +2216,7 @@ declare module 'buffer' {
              * Equivalent to `buf.indexOf() !== -1`.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from('this is a buffer');
              *
@@ -2152,7 +2246,7 @@ declare module 'buffer' {
              * Creates and returns an [iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) of `buf` keys (indices).
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from('buffer');
              *
@@ -2175,7 +2269,7 @@ declare module 'buffer' {
              * called automatically when a `Buffer` is used in a `for..of` statement.
              *
              * ```js
-             * import { Buffer } from 'buffer';
+             * import { Buffer } from 'node:buffer';
              *
              * const buf = Buffer.from('buffer');
              *
@@ -2218,7 +2312,7 @@ declare module 'buffer' {
          * **For code running using Node.js APIs, converting between base64-encoded strings**
          * **and binary data should be performed using `Buffer.from(str, 'base64')` and`buf.toString('base64')`.**
          * @since v15.13.0, v14.17.0
-         * @deprecated Use `Buffer.from(data, 'base64')` instead.
+         * @legacy Use `Buffer.from(data, 'base64')` instead.
          * @param data The Base64-encoded input string.
          */
         function atob(data: string): string;
@@ -2234,11 +2328,10 @@ declare module 'buffer' {
          * **For code running using Node.js APIs, converting between base64-encoded strings**
          * **and binary data should be performed using `Buffer.from(str, 'base64')` and`buf.toString('base64')`.**
          * @since v15.13.0, v14.17.0
-         * @deprecated Use `buf.toString('base64')` instead.
+         * @legacy Use `buf.toString('base64')` instead.
          * @param data An ASCII (Latin1) string.
          */
         function btoa(data: string): string;
-
         interface Blob extends __Blob {}
         /**
          * `Blob` class is a global reference for `require('node:buffer').Blob`