@types/node 16.18.53 → 16.18.54

node v16.18/fs/promises.d.ts

@@ -8,9 +8,9 @@
  * concurrent modifications on the same file or data corruption may occur.
  * @since v10.0.0
  */
-declare module 'fs/promises' {
-    import { Abortable } from 'node:events';
-    import { Stream } from 'node:stream';
+declare module "fs/promises" {
+    import { Abortable } from "node:events";
+    import { Stream } from "node:stream";
     import {
         BigIntStats,
         BufferEncodingOption,
@@ -34,7 +34,7 @@ declare module 'fs/promises' {
         WatchOptions,
         WriteStream,
         WriteVResult,
-    } from 'node:fs';
+    } from "node:fs";
     interface FileChangeInfo<T extends string | Buffer> {
         eventType: WatchEventType;
         filename: T | null;
@@ -92,7 +92,10 @@ declare module 'fs/promises' {
          * @since v10.0.0
          * @return Fulfills with `undefined` upon success.
          */
-        appendFile(data: string | Uint8Array, options?: (ObjectEncodingOptions & FlagAndOpenMode) | BufferEncoding | null): Promise<void>;
+        appendFile(
+            data: string | Uint8Array,
+            options?: (ObjectEncodingOptions & FlagAndOpenMode) | BufferEncoding | null,
+        ): Promise<void>;
         /**
          * Changes the ownership of the file. A wrapper for [`chown(2)`](http://man7.org/linux/man-pages/man2/chown.2.html).
          * @since v10.0.0
@@ -209,7 +212,12 @@ declare module 'fs/promises' {
          * integer, the current file position will remain unchanged.
          * @return Fulfills upon success with an object with two properties:
          */
-        read<T extends ArrayBufferView>(buffer: T, offset?: number | null, length?: number | null, position?: number | null): Promise<FileReadResult<T>>;
+        read<T extends ArrayBufferView>(
+            buffer: T,
+            offset?: number | null,
+            length?: number | null,
+            position?: number | null,
+        ): Promise<FileReadResult<T>>;
         read<T extends ArrayBufferView = Buffer>(options?: FileReadOptions<T>): Promise<FileReadResult<T>>;
         /**
          * Asynchronously reads the entire contents of a file.
@@ -229,7 +237,7 @@ declare module 'fs/promises' {
             options?: {
                 encoding?: null | undefined;
                 flag?: OpenMode | undefined;
-            } | null
+            } | null,
         ): Promise<Buffer>;
         /**
          * Asynchronously reads the entire contents of a file. The underlying file will _not_ be closed automatically.
@@ -240,10 +248,10 @@ declare module 'fs/promises' {
         readFile(
             options:
                 | {
-                      encoding: BufferEncoding;
-                      flag?: OpenMode | undefined;
-                  }
-                | BufferEncoding
+                    encoding: BufferEncoding;
+                    flag?: OpenMode | undefined;
+                }
+                | BufferEncoding,
         ): Promise<string>;
         /**
          * Asynchronously reads the entire contents of a file. The underlying file will _not_ be closed automatically.
@@ -254,10 +262,10 @@ declare module 'fs/promises' {
         readFile(
             options?:
                 | (ObjectEncodingOptions & {
-                      flag?: OpenMode | undefined;
-                  })
+                    flag?: OpenMode | undefined;
+                })
                 | BufferEncoding
-                | null
+                | null,
         ): Promise<string | Buffer>;
         /**
          * @since v10.0.0
@@ -266,12 +274,12 @@ declare module 'fs/promises' {
         stat(
             opts?: StatOptions & {
                 bigint?: false | undefined;
-            }
+            },
         ): Promise<Stats>;
         stat(
             opts: StatOptions & {
                 bigint: true;
-            }
+            },
         ): Promise<BigIntStats>;
         stat(opts?: StatOptions): Promise<Stats | BigIntStats>;
         /**
@@ -327,7 +335,10 @@ declare module 'fs/promises' {
          * beginning of the file.
          * @since v10.0.0
          */
-        writeFile(data: string | Uint8Array, options?: (ObjectEncodingOptions & FlagAndOpenMode & Abortable) | BufferEncoding | null): Promise<void>;
+        writeFile(
+            data: string | Uint8Array,
+            options?: (ObjectEncodingOptions & FlagAndOpenMode & Abortable) | BufferEncoding | null,
+        ): Promise<void>;
         /**
          * Write `buffer` to the file.
          *
@@ -352,7 +363,7 @@ declare module 'fs/promises' {
             buffer: TBuffer,
             offset?: number | null,
             length?: number | null,
-            position?: number | null
+            position?: number | null,
         ): Promise<{
             bytesWritten: number;
             buffer: TBuffer;
@@ -360,7 +371,7 @@ declare module 'fs/promises' {
         write(
             data: string,
             position?: number | null,
-            encoding?: BufferEncoding | null
+            encoding?: BufferEncoding | null,
         ): Promise<{
             bytesWritten: number;
             buffer: string;
@@ -536,7 +547,7 @@ declare module 'fs/promises' {
         path: PathLike,
         options: MakeDirectoryOptions & {
             recursive: true;
-        }
+        },
     ): Promise<string | undefined>;
     /**
      * Asynchronous mkdir(2) - create a directory.
@@ -549,9 +560,9 @@ declare module 'fs/promises' {
         options?:
             | Mode
             | (MakeDirectoryOptions & {
-                  recursive?: false | undefined;
-              })
-            | null
+                recursive?: false | undefined;
+            })
+            | null,
     ): Promise<void>;
     /**
      * Asynchronous mkdir(2) - create a directory.
@@ -588,10 +599,10 @@ declare module 'fs/promises' {
         path: PathLike,
         options?:
             | (ObjectEncodingOptions & {
-                  withFileTypes?: false | undefined;
-              })
+                withFileTypes?: false | undefined;
+            })
             | BufferEncoding
-            | null
+            | null,
     ): Promise<string[]>;
     /**
      * Asynchronous readdir(3) - read a directory.
@@ -602,10 +613,10 @@ declare module 'fs/promises' {
         path: PathLike,
         options:
             | {
-                  encoding: 'buffer';
-                  withFileTypes?: false | undefined;
-              }
-            | 'buffer'
+                encoding: "buffer";
+                withFileTypes?: false | undefined;
+            }
+            | "buffer",
     ): Promise<Buffer[]>;
     /**
      * Asynchronous readdir(3) - read a directory.
@@ -616,10 +627,10 @@ declare module 'fs/promises' {
         path: PathLike,
         options?:
             | (ObjectEncodingOptions & {
-                  withFileTypes?: false | undefined;
-              })
+                withFileTypes?: false | undefined;
+            })
             | BufferEncoding
-            | null
+            | null,
     ): Promise<string[] | Buffer[]>;
     /**
      * Asynchronous readdir(3) - read a directory.
@@ -630,7 +641,7 @@ declare module 'fs/promises' {
         path: PathLike,
         options: ObjectEncodingOptions & {
             withFileTypes: true;
-        }
+        },
     ): Promise<Dirent[]>;
     /**
      * Reads the contents of the symbolic link referred to by `path`. See the POSIX [`readlink(2)`](http://man7.org/linux/man-pages/man2/readlink.2.html) documentation for more detail. The promise is
@@ -678,13 +689,13 @@ declare module 'fs/promises' {
         path: PathLike,
         opts?: StatOptions & {
             bigint?: false | undefined;
-        }
+        },
     ): Promise<Stats>;
     function lstat(
         path: PathLike,
         opts: StatOptions & {
             bigint: true;
-        }
+        },
     ): Promise<BigIntStats>;
     function lstat(path: PathLike, opts?: StatOptions): Promise<Stats | BigIntStats>;
     /**
@@ -695,13 +706,13 @@ declare module 'fs/promises' {
         path: PathLike,
         opts?: StatOptions & {
             bigint?: false | undefined;
-        }
+        },
     ): Promise<Stats>;
     function stat(
         path: PathLike,
         opts: StatOptions & {
             bigint: true;
-        }
+        },
     ): Promise<BigIntStats>;
     function stat(path: PathLike, opts?: StatOptions): Promise<Stats | BigIntStats>;
     /**
@@ -792,7 +803,10 @@ declare module 'fs/promises' {
      * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
      * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'` is used.
      */
-    function realpath(path: PathLike, options?: ObjectEncodingOptions | BufferEncoding | null): Promise<string | Buffer>;
+    function realpath(
+        path: PathLike,
+        options?: ObjectEncodingOptions | BufferEncoding | null,
+    ): Promise<string | Buffer>;
     /**
      * Creates a unique temporary directory. A unique directory name is generated by
      * appending six random characters to the end of the provided `prefix`. Due to
@@ -883,14 +897,19 @@ declare module 'fs/promises' {
      */
     function writeFile(
         file: PathLike | FileHandle,
-        data: string | NodeJS.ArrayBufferView | Iterable<string | NodeJS.ArrayBufferView> | AsyncIterable<string | NodeJS.ArrayBufferView> | Stream,
+        data:
+            | string
+            | NodeJS.ArrayBufferView
+            | Iterable<string | NodeJS.ArrayBufferView>
+            | AsyncIterable<string | NodeJS.ArrayBufferView>
+            | Stream,
         options?:
             | (ObjectEncodingOptions & {
-                  mode?: Mode | undefined;
-                  flag?: OpenMode | undefined;
-              } & Abortable)
+                mode?: Mode | undefined;
+                flag?: OpenMode | undefined;
+            } & Abortable)
             | BufferEncoding
-            | null
+            | null,
     ): Promise<void>;
     /**
      * Asynchronously append data to a file, creating the file if it does not yet
@@ -906,7 +925,11 @@ declare module 'fs/promises' {
      * @param path filename or {FileHandle}
      * @return Fulfills with `undefined` upon success.
      */
-    function appendFile(path: PathLike | FileHandle, data: string | Uint8Array, options?: (ObjectEncodingOptions & FlagAndOpenMode) | BufferEncoding | null): Promise<void>;
+    function appendFile(
+        path: PathLike | FileHandle,
+        data: string | Uint8Array,
+        options?: (ObjectEncodingOptions & FlagAndOpenMode) | BufferEncoding | null,
+    ): Promise<void>;
     /**
      * Asynchronously reads the entire contents of a file.
      *
@@ -953,10 +976,10 @@ declare module 'fs/promises' {
         path: PathLike | FileHandle,
         options?:
             | ({
-                  encoding?: null | undefined;
-                  flag?: OpenMode | undefined;
-              } & Abortable)
-            | null
+                encoding?: null | undefined;
+                flag?: OpenMode | undefined;
+            } & Abortable)
+            | null,
     ): Promise<Buffer>;
     /**
      * Asynchronously reads the entire contents of a file.
@@ -969,10 +992,10 @@ declare module 'fs/promises' {
         path: PathLike | FileHandle,
         options:
             | ({
-                  encoding: BufferEncoding;
-                  flag?: OpenMode | undefined;
-              } & Abortable)
-            | BufferEncoding
+                encoding: BufferEncoding;
+                flag?: OpenMode | undefined;
+            } & Abortable)
+            | BufferEncoding,
     ): Promise<string>;
     /**
      * Asynchronously reads the entire contents of a file.
@@ -984,12 +1007,15 @@ declare module 'fs/promises' {
     function readFile(
         path: PathLike | FileHandle,
         options?:
-            | (ObjectEncodingOptions &
-                  Abortable & {
-                      flag?: OpenMode | undefined;
-                  })
+            | (
+                & ObjectEncodingOptions
+                & Abortable
+                & {
+                    flag?: OpenMode | undefined;
+                }
+            )
             | BufferEncoding
-            | null
+            | null,
     ): Promise<string | Buffer>;
     /**
      * Asynchronously open a directory for iterative scanning. See the POSIX [`opendir(3)`](http://man7.org/linux/man-pages/man3/opendir.3.html) documentation for more detail.
@@ -1054,9 +1080,9 @@ declare module 'fs/promises' {
         filename: PathLike,
         options:
             | (WatchOptions & {
-                  encoding: 'buffer';
-              })
-            | 'buffer'
+                encoding: "buffer";
+            })
+            | "buffer",
     ): AsyncIterable<FileChangeInfo<Buffer>>;
     /**
      * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
@@ -1075,7 +1101,10 @@ declare module 'fs/promises' {
      * If `persistent` is not supplied, the default of `true` is used.
      * If `recursive` is not supplied, the default of `false` is used.
      */
-    function watch(filename: PathLike, options: WatchOptions | string): AsyncIterable<FileChangeInfo<string>> | AsyncIterable<FileChangeInfo<Buffer>>;
+    function watch(
+        filename: PathLike,
+        options: WatchOptions | string,
+    ): AsyncIterable<FileChangeInfo<string>> | AsyncIterable<FileChangeInfo<Buffer>>;
     /**
      * Asynchronously copies the entire directory structure from `src` to `dest`,
      * including subdirectories and files.
@@ -1090,6 +1119,6 @@ declare module 'fs/promises' {
      */
     function cp(source: string | URL, destination: string | URL, opts?: CopyOptions): Promise<void>;
 }
-declare module 'node:fs/promises' {
-    export * from 'fs/promises';
+declare module "node:fs/promises" {
+    export * from "fs/promises";
 }