@types/node 18.17.18 → 18.18.0

{node v18.17 → node v18.18}/child_process.d.ts

@@ -65,12 +65,12 @@
  * stalling the event loop while spawned processes complete.
  * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/child_process.js)
  */
-declare module 'child_process' {
-    import { ObjectEncodingOptions } from 'node:fs';
-    import { EventEmitter, Abortable } from 'node:events';
-    import * as net from 'node:net';
-    import { Writable, Readable, Stream, Pipe } from 'node:stream';
-    import { URL } from 'node:url';
+declare module "child_process" {
+    import { ObjectEncodingOptions } from "node:fs";
+    import { Abortable, EventEmitter } from "node:events";
+    import * as net from "node:net";
+    import { Pipe, Readable, Stream, Writable } from "node:stream";
+    import { URL } from "node:url";
     type Serializable = string | object | number | boolean | bigint;
     type SendHandle = net.Socket | net.Server;
     /**
@@ -189,7 +189,7 @@ declare module 'child_process' {
             // stderr
             Readable | Writable | null | undefined,
             // extra
-            Readable | Writable | null | undefined // extra
+            Readable | Writable | null | undefined, // extra
         ];
         /**
          * The `subprocess.killed` property indicates whether the child process
@@ -305,6 +305,11 @@ declare module 'child_process' {
          * @since v0.1.90
          */
         kill(signal?: NodeJS.Signals | number): boolean;
+        /**
+         * Calls {@link ChildProcess.kill} with `'SIGTERM'`.
+         * @since v18.18.0
+         */
+        [Symbol.dispose](): void;
         /**
          * When an IPC channel has been established between the parent and child (
          * i.e. when using {@link fork}), the `subprocess.send()` method can
@@ -457,7 +462,12 @@ declare module 'child_process' {
          */
         send(message: Serializable, callback?: (error: Error | null) => void): boolean;
         send(message: Serializable, sendHandle?: SendHandle, callback?: (error: Error | null) => void): boolean;
-        send(message: Serializable, sendHandle?: SendHandle, options?: MessageOptions, callback?: (error: Error | null) => void): boolean;
+        send(
+            message: Serializable,
+            sendHandle?: SendHandle,
+            options?: MessageOptions,
+            callback?: (error: Error | null) => void,
+        ): boolean;
         /**
          * Closes the IPC channel between parent and child, allowing the child to exit
          * gracefully once there are no other connections keeping it alive. After calling
@@ -523,47 +533,53 @@ declare module 'child_process' {
          * 6. spawn
          */
         addListener(event: string, listener: (...args: any[]) => void): this;
-        addListener(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        addListener(event: 'disconnect', listener: () => void): this;
-        addListener(event: 'error', listener: (err: Error) => void): this;
-        addListener(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        addListener(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-        addListener(event: 'spawn', listener: () => void): this;
+        addListener(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+        addListener(event: "disconnect", listener: () => void): this;
+        addListener(event: "error", listener: (err: Error) => void): this;
+        addListener(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+        addListener(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+        addListener(event: "spawn", listener: () => void): this;
         emit(event: string | symbol, ...args: any[]): boolean;
-        emit(event: 'close', code: number | null, signal: NodeJS.Signals | null): boolean;
-        emit(event: 'disconnect'): boolean;
-        emit(event: 'error', err: Error): boolean;
-        emit(event: 'exit', code: number | null, signal: NodeJS.Signals | null): boolean;
-        emit(event: 'message', message: Serializable, sendHandle: SendHandle): boolean;
-        emit(event: 'spawn', listener: () => void): boolean;
+        emit(event: "close", code: number | null, signal: NodeJS.Signals | null): boolean;
+        emit(event: "disconnect"): boolean;
+        emit(event: "error", err: Error): boolean;
+        emit(event: "exit", code: number | null, signal: NodeJS.Signals | null): boolean;
+        emit(event: "message", message: Serializable, sendHandle: SendHandle): boolean;
+        emit(event: "spawn", listener: () => void): boolean;
         on(event: string, listener: (...args: any[]) => void): this;
-        on(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        on(event: 'disconnect', listener: () => void): this;
-        on(event: 'error', listener: (err: Error) => void): this;
-        on(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        on(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-        on(event: 'spawn', listener: () => void): this;
+        on(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+        on(event: "disconnect", listener: () => void): this;
+        on(event: "error", listener: (err: Error) => void): this;
+        on(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+        on(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+        on(event: "spawn", listener: () => void): this;
         once(event: string, listener: (...args: any[]) => void): this;
-        once(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        once(event: 'disconnect', listener: () => void): this;
-        once(event: 'error', listener: (err: Error) => void): this;
-        once(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        once(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-        once(event: 'spawn', listener: () => void): this;
+        once(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+        once(event: "disconnect", listener: () => void): this;
+        once(event: "error", listener: (err: Error) => void): this;
+        once(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+        once(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+        once(event: "spawn", listener: () => void): this;
         prependListener(event: string, listener: (...args: any[]) => void): this;
-        prependListener(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        prependListener(event: 'disconnect', listener: () => void): this;
-        prependListener(event: 'error', listener: (err: Error) => void): this;
-        prependListener(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        prependListener(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-        prependListener(event: 'spawn', listener: () => void): this;
+        prependListener(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+        prependListener(event: "disconnect", listener: () => void): this;
+        prependListener(event: "error", listener: (err: Error) => void): this;
+        prependListener(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+        prependListener(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+        prependListener(event: "spawn", listener: () => void): this;
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
-        prependOnceListener(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        prependOnceListener(event: 'disconnect', listener: () => void): this;
-        prependOnceListener(event: 'error', listener: (err: Error) => void): this;
-        prependOnceListener(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
-        prependOnceListener(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-        prependOnceListener(event: 'spawn', listener: () => void): this;
+        prependOnceListener(
+            event: "close",
+            listener: (code: number | null, signal: NodeJS.Signals | null) => void,
+        ): this;
+        prependOnceListener(event: "disconnect", listener: () => void): this;
+        prependOnceListener(event: "error", listener: (err: Error) => void): this;
+        prependOnceListener(
+            event: "exit",
+            listener: (code: number | null, signal: NodeJS.Signals | null) => void,
+        ): this;
+        prependOnceListener(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+        prependOnceListener(event: "spawn", listener: () => void): this;
     }
     // return this object when stdio option is undefined or not specified
     interface ChildProcessWithoutNullStreams extends ChildProcess {
@@ -577,11 +593,13 @@ declare module 'child_process' {
             // stderr
             Readable | Writable | null | undefined,
             // extra, no modification
-            Readable | Writable | null | undefined // extra, no modification
+            Readable | Writable | null | undefined, // extra, no modification
         ];
     }
     // return this object when stdio option is a tuple of 3
-    interface ChildProcessByStdio<I extends null | Writable, O extends null | Readable, E extends null | Readable> extends ChildProcess {
+    interface ChildProcessByStdio<I extends null | Writable, O extends null | Readable, E extends null | Readable>
+        extends ChildProcess
+    {
         stdin: I;
         stdout: O;
         stderr: E;
@@ -591,15 +609,15 @@ declare module 'child_process' {
             E,
             Readable | Writable | null | undefined,
             // extra, no modification
-            Readable | Writable | null | undefined // extra, no modification
+            Readable | Writable | null | undefined, // extra, no modification
         ];
     }
     interface MessageOptions {
         keepOpen?: boolean | undefined;
     }
-    type IOType = 'overlapped' | 'pipe' | 'ignore' | 'inherit';
-    type StdioOptions = IOType | Array<IOType | 'ipc' | Stream | number | null | undefined>;
-    type SerializationType = 'json' | 'advanced';
+    type IOType = "overlapped" | "pipe" | "ignore" | "inherit";
+    type StdioOptions = IOType | Array<IOType | "ipc" | Stream | number | null | undefined>;
+    type SerializationType = "json" | "advanced";
     interface MessagingOptions extends Abortable {
         /**
          * Specify the kind of serialization used for sending messages between processes.
@@ -653,10 +671,14 @@ declare module 'child_process' {
     interface SpawnOptionsWithoutStdio extends SpawnOptions {
         stdio?: StdioPipeNamed | StdioPipe[] | undefined;
     }
-    type StdioNull = 'inherit' | 'ignore' | Stream;
-    type StdioPipeNamed = 'pipe' | 'overlapped';
+    type StdioNull = "inherit" | "ignore" | Stream;
+    type StdioPipeNamed = "pipe" | "overlapped";
     type StdioPipe = undefined | null | StdioPipeNamed;
-    interface SpawnOptionsWithStdioTuple<Stdin extends StdioNull | StdioPipe, Stdout extends StdioNull | StdioPipe, Stderr extends StdioNull | StdioPipe> extends SpawnOptions {
+    interface SpawnOptionsWithStdioTuple<
+        Stdin extends StdioNull | StdioPipe,
+        Stdout extends StdioNull | StdioPipe,
+        Stderr extends StdioNull | StdioPipe,
+    > extends SpawnOptions {
         stdio: [Stdin, Stdout, Stderr];
     }
     /**
@@ -779,25 +801,85 @@ declare module 'child_process' {
      * @param args List of string arguments.
      */
     function spawn(command: string, options?: SpawnOptionsWithoutStdio): ChildProcessWithoutNullStreams;
-    function spawn(command: string, options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioPipe>): ChildProcessByStdio<Writable, Readable, Readable>;
-    function spawn(command: string, options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioNull>): ChildProcessByStdio<Writable, Readable, null>;
-    function spawn(command: string, options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioPipe>): ChildProcessByStdio<Writable, null, Readable>;
-    function spawn(command: string, options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioPipe>): ChildProcessByStdio<null, Readable, Readable>;
-    function spawn(command: string, options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioNull>): ChildProcessByStdio<Writable, null, null>;
-    function spawn(command: string, options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioNull>): ChildProcessByStdio<null, Readable, null>;
-    function spawn(command: string, options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioPipe>): ChildProcessByStdio<null, null, Readable>;
-    function spawn(command: string, options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioNull>): ChildProcessByStdio<null, null, null>;
+    function spawn(
+        command: string,
+        options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioPipe>,
+    ): ChildProcessByStdio<Writable, Readable, Readable>;
+    function spawn(
+        command: string,
+        options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioNull>,
+    ): ChildProcessByStdio<Writable, Readable, null>;
+    function spawn(
+        command: string,
+        options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioPipe>,
+    ): ChildProcessByStdio<Writable, null, Readable>;
+    function spawn(
+        command: string,
+        options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioPipe>,
+    ): ChildProcessByStdio<null, Readable, Readable>;
+    function spawn(
+        command: string,
+        options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioNull>,
+    ): ChildProcessByStdio<Writable, null, null>;
+    function spawn(
+        command: string,
+        options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioNull>,
+    ): ChildProcessByStdio<null, Readable, null>;
+    function spawn(
+        command: string,
+        options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioPipe>,
+    ): ChildProcessByStdio<null, null, Readable>;
+    function spawn(
+        command: string,
+        options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioNull>,
+    ): ChildProcessByStdio<null, null, null>;
     function spawn(command: string, options: SpawnOptions): ChildProcess;
     // overloads of spawn with 'args'
-    function spawn(command: string, args?: ReadonlyArray<string>, options?: SpawnOptionsWithoutStdio): ChildProcessWithoutNullStreams;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioPipe>): ChildProcessByStdio<Writable, Readable, Readable>;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioNull>): ChildProcessByStdio<Writable, Readable, null>;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioPipe>): ChildProcessByStdio<Writable, null, Readable>;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioPipe>): ChildProcessByStdio<null, Readable, Readable>;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioNull>): ChildProcessByStdio<Writable, null, null>;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioNull>): ChildProcessByStdio<null, Readable, null>;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioPipe>): ChildProcessByStdio<null, null, Readable>;
-    function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioNull>): ChildProcessByStdio<null, null, null>;
+    function spawn(
+        command: string,
+        args?: ReadonlyArray<string>,
+        options?: SpawnOptionsWithoutStdio,
+    ): ChildProcessWithoutNullStreams;
+    function spawn(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioPipe>,
+    ): ChildProcessByStdio<Writable, Readable, Readable>;
+    function spawn(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnOptionsWithStdioTuple<StdioPipe, StdioPipe, StdioNull>,
+    ): ChildProcessByStdio<Writable, Readable, null>;
+    function spawn(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioPipe>,
+    ): ChildProcessByStdio<Writable, null, Readable>;
+    function spawn(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioPipe>,
+    ): ChildProcessByStdio<null, Readable, Readable>;
+    function spawn(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnOptionsWithStdioTuple<StdioPipe, StdioNull, StdioNull>,
+    ): ChildProcessByStdio<Writable, null, null>;
+    function spawn(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioNull>,
+    ): ChildProcessByStdio<null, Readable, null>;
+    function spawn(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioPipe>,
+    ): ChildProcessByStdio<null, null, Readable>;
+    function spawn(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnOptionsWithStdioTuple<StdioNull, StdioNull, StdioNull>,
+    ): ChildProcessByStdio<null, null, null>;
     function spawn(command: string, args: ReadonlyArray<string>, options: SpawnOptions): ChildProcess;
     interface ExecOptions extends CommonOptions {
         shell?: string | undefined;
@@ -902,14 +984,17 @@ declare module 'child_process' {
      * @param command The command to run, with space-separated arguments.
      * @param callback called with the output when process terminates.
      */
-    function exec(command: string, callback?: (error: ExecException | null, stdout: string, stderr: string) => void): ChildProcess;
+    function exec(
+        command: string,
+        callback?: (error: ExecException | null, stdout: string, stderr: string) => void,
+    ): ChildProcess;
     // `options` with `"buffer"` or `null` for `encoding` means stdout/stderr are definitely `Buffer`.
     function exec(
         command: string,
         options: {
-            encoding: 'buffer' | null;
+            encoding: "buffer" | null;
         } & ExecOptions,
-        callback?: (error: ExecException | null, stdout: Buffer, stderr: Buffer) => void
+        callback?: (error: ExecException | null, stdout: Buffer, stderr: Buffer) => void,
     ): ChildProcess;
     // `options` with well known `encoding` means stdout/stderr are definitely `string`.
     function exec(
@@ -917,7 +1002,7 @@ declare module 'child_process' {
         options: {
             encoding: BufferEncoding;
         } & ExecOptions,
-        callback?: (error: ExecException | null, stdout: string, stderr: string) => void
+        callback?: (error: ExecException | null, stdout: string, stderr: string) => void,
     ): ChildProcess;
     // `options` with an `encoding` whose type is `string` means stdout/stderr could either be `Buffer` or `string`.
     // There is no guarantee the `encoding` is unknown as `string` is a superset of `BufferEncoding`.
@@ -926,15 +1011,19 @@ declare module 'child_process' {
         options: {
             encoding: BufferEncoding;
         } & ExecOptions,
-        callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void
+        callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
     ): ChildProcess;
     // `options` without an `encoding` means stdout/stderr are definitely `string`.
-    function exec(command: string, options: ExecOptions, callback?: (error: ExecException | null, stdout: string, stderr: string) => void): ChildProcess;
+    function exec(
+        command: string,
+        options: ExecOptions,
+        callback?: (error: ExecException | null, stdout: string, stderr: string) => void,
+    ): ChildProcess;
     // fallback if nothing else matches. Worst case is always `string | Buffer`.
     function exec(
         command: string,
         options: (ObjectEncodingOptions & ExecOptions) | undefined | null,
-        callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void
+        callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
     ): ChildProcess;
     interface PromiseWithChild<T> extends Promise<T> {
         child: ChildProcess;
@@ -947,8 +1036,8 @@ declare module 'child_process' {
         function __promisify__(
             command: string,
             options: {
-                encoding: 'buffer' | null;
-            } & ExecOptions
+                encoding: "buffer" | null;
+            } & ExecOptions,
         ): PromiseWithChild<{
             stdout: Buffer;
             stderr: Buffer;
@@ -957,21 +1046,21 @@ declare module 'child_process' {
             command: string,
             options: {
                 encoding: BufferEncoding;
-            } & ExecOptions
+            } & ExecOptions,
         ): PromiseWithChild<{
             stdout: string;
             stderr: string;
         }>;
         function __promisify__(
             command: string,
-            options: ExecOptions
+            options: ExecOptions,
         ): PromiseWithChild<{
             stdout: string;
             stderr: string;
         }>;
         function __promisify__(
             command: string,
-            options?: (ObjectEncodingOptions & ExecOptions) | null
+            options?: (ObjectEncodingOptions & ExecOptions) | null,
         ): PromiseWithChild<{
             stdout: string | Buffer;
             stderr: string | Buffer;
@@ -988,14 +1077,14 @@ declare module 'child_process' {
         encoding: BufferEncoding;
     }
     interface ExecFileOptionsWithBufferEncoding extends ExecFileOptions {
-        encoding: 'buffer' | null;
+        encoding: "buffer" | null;
     }
     interface ExecFileOptionsWithOtherEncoding extends ExecFileOptions {
         encoding: BufferEncoding;
     }
     type ExecFileException =
-        & Omit<ExecException, 'code'>
-        & Omit<NodeJS.ErrnoException, 'code'>
+        & Omit<ExecException, "code">
+        & Omit<NodeJS.ErrnoException, "code">
         & { code?: string | number | undefined | null };
     /**
      * The `child_process.execFile()` function is similar to {@link exec} except that it does not spawn a shell by default. Rather, the specified
@@ -1061,56 +1150,92 @@ declare module 'child_process' {
      * @param callback Called with the output when process terminates.
      */
     function execFile(file: string): ChildProcess;
-    function execFile(file: string, options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null): ChildProcess;
+    function execFile(
+        file: string,
+        options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
+    ): ChildProcess;
     function execFile(file: string, args?: ReadonlyArray<string> | null): ChildProcess;
-    function execFile(file: string, args: ReadonlyArray<string> | undefined | null, options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null): ChildProcess;
+    function execFile(
+        file: string,
+        args: ReadonlyArray<string> | undefined | null,
+        options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
+    ): ChildProcess;
     // no `options` definitely means stdout/stderr are `string`.
-    function execFile(file: string, callback: (error: ExecFileException | null, stdout: string, stderr: string) => void): ChildProcess;
-    function execFile(file: string, args: ReadonlyArray<string> | undefined | null, callback: (error: ExecFileException | null, stdout: string, stderr: string) => void): ChildProcess;
+    function execFile(
+        file: string,
+        callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
+    ): ChildProcess;
+    function execFile(
+        file: string,
+        args: ReadonlyArray<string> | undefined | null,
+        callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
+    ): ChildProcess;
     // `options` with `"buffer"` or `null` for `encoding` means stdout/stderr are definitely `Buffer`.
-    function execFile(file: string, options: ExecFileOptionsWithBufferEncoding, callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void): ChildProcess;
+    function execFile(
+        file: string,
+        options: ExecFileOptionsWithBufferEncoding,
+        callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void,
+    ): ChildProcess;
     function execFile(
         file: string,
         args: ReadonlyArray<string> | undefined | null,
         options: ExecFileOptionsWithBufferEncoding,
-        callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void
+        callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void,
     ): ChildProcess;
     // `options` with well known `encoding` means stdout/stderr are definitely `string`.
-    function execFile(file: string, options: ExecFileOptionsWithStringEncoding, callback: (error: ExecFileException | null, stdout: string, stderr: string) => void): ChildProcess;
+    function execFile(
+        file: string,
+        options: ExecFileOptionsWithStringEncoding,
+        callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
+    ): ChildProcess;
     function execFile(
         file: string,
         args: ReadonlyArray<string> | undefined | null,
         options: ExecFileOptionsWithStringEncoding,
-        callback: (error: ExecFileException | null, stdout: string, stderr: string) => void
+        callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
     ): ChildProcess;
     // `options` with an `encoding` whose type is `string` means stdout/stderr could either be `Buffer` or `string`.
     // There is no guarantee the `encoding` is unknown as `string` is a superset of `BufferEncoding`.
-    function execFile(file: string, options: ExecFileOptionsWithOtherEncoding, callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void): ChildProcess;
+    function execFile(
+        file: string,
+        options: ExecFileOptionsWithOtherEncoding,
+        callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
+    ): ChildProcess;
     function execFile(
         file: string,
         args: ReadonlyArray<string> | undefined | null,
         options: ExecFileOptionsWithOtherEncoding,
-        callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void
+        callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
     ): ChildProcess;
     // `options` without an `encoding` means stdout/stderr are definitely `string`.
-    function execFile(file: string, options: ExecFileOptions, callback: (error: ExecFileException | null, stdout: string, stderr: string) => void): ChildProcess;
+    function execFile(
+        file: string,
+        options: ExecFileOptions,
+        callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
+    ): ChildProcess;
     function execFile(
         file: string,
         args: ReadonlyArray<string> | undefined | null,
         options: ExecFileOptions,
-        callback: (error: ExecFileException | null, stdout: string, stderr: string) => void
+        callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
     ): ChildProcess;
     // fallback if nothing else matches. Worst case is always `string | Buffer`.
     function execFile(
         file: string,
         options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
-        callback: ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void) | undefined | null
+        callback:
+            | ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void)
+            | undefined
+            | null,
     ): ChildProcess;
     function execFile(
         file: string,
         args: ReadonlyArray<string> | undefined | null,
         options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
-        callback: ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void) | undefined | null
+        callback:
+            | ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void)
+            | undefined
+            | null,
     ): ChildProcess;
     namespace execFile {
         function __promisify__(file: string): PromiseWithChild<{
@@ -1119,14 +1244,14 @@ declare module 'child_process' {
         }>;
         function __promisify__(
             file: string,
-            args: ReadonlyArray<string> | undefined | null
+            args: ReadonlyArray<string> | undefined | null,
         ): PromiseWithChild<{
             stdout: string;
             stderr: string;
         }>;
         function __promisify__(
             file: string,
-            options: ExecFileOptionsWithBufferEncoding
+            options: ExecFileOptionsWithBufferEncoding,
         ): PromiseWithChild<{
             stdout: Buffer;
             stderr: Buffer;
@@ -1134,14 +1259,14 @@ declare module 'child_process' {
         function __promisify__(
             file: string,
             args: ReadonlyArray<string> | undefined | null,
-            options: ExecFileOptionsWithBufferEncoding
+            options: ExecFileOptionsWithBufferEncoding,
         ): PromiseWithChild<{
             stdout: Buffer;
             stderr: Buffer;
         }>;
         function __promisify__(
             file: string,
-            options: ExecFileOptionsWithStringEncoding
+            options: ExecFileOptionsWithStringEncoding,
         ): PromiseWithChild<{
             stdout: string;
             stderr: string;
@@ -1149,14 +1274,14 @@ declare module 'child_process' {
         function __promisify__(
             file: string,
             args: ReadonlyArray<string> | undefined | null,
-            options: ExecFileOptionsWithStringEncoding
+            options: ExecFileOptionsWithStringEncoding,
         ): PromiseWithChild<{
             stdout: string;
             stderr: string;
         }>;
         function __promisify__(
             file: string,
-            options: ExecFileOptionsWithOtherEncoding
+            options: ExecFileOptionsWithOtherEncoding,
         ): PromiseWithChild<{
             stdout: string | Buffer;
             stderr: string | Buffer;
@@ -1164,14 +1289,14 @@ declare module 'child_process' {
         function __promisify__(
             file: string,
             args: ReadonlyArray<string> | undefined | null,
-            options: ExecFileOptionsWithOtherEncoding
+            options: ExecFileOptionsWithOtherEncoding,
         ): PromiseWithChild<{
             stdout: string | Buffer;
             stderr: string | Buffer;
         }>;
         function __promisify__(
             file: string,
-            options: ExecFileOptions
+            options: ExecFileOptions,
         ): PromiseWithChild<{
             stdout: string;
             stderr: string;
@@ -1179,14 +1304,14 @@ declare module 'child_process' {
         function __promisify__(
             file: string,
             args: ReadonlyArray<string> | undefined | null,
-            options: ExecFileOptions
+            options: ExecFileOptions,
         ): PromiseWithChild<{
             stdout: string;
             stderr: string;
         }>;
         function __promisify__(
             file: string,
-            options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null
+            options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
         ): PromiseWithChild<{
             stdout: string | Buffer;
             stderr: string | Buffer;
@@ -1194,7 +1319,7 @@ declare module 'child_process' {
         function __promisify__(
             file: string,
             args: ReadonlyArray<string> | undefined | null,
-            options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null
+            options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
         ): PromiseWithChild<{
             stdout: string | Buffer;
             stderr: string | Buffer;
@@ -1271,13 +1396,13 @@ declare module 'child_process' {
     interface SpawnSyncOptions extends CommonSpawnOptions {
         input?: string | NodeJS.ArrayBufferView | undefined;
         maxBuffer?: number | undefined;
-        encoding?: BufferEncoding | 'buffer' | null | undefined;
+        encoding?: BufferEncoding | "buffer" | null | undefined;
     }
     interface SpawnSyncOptionsWithStringEncoding extends SpawnSyncOptions {
         encoding: BufferEncoding;
     }
     interface SpawnSyncOptionsWithBufferEncoding extends SpawnSyncOptions {
-        encoding?: 'buffer' | null | undefined;
+        encoding?: "buffer" | null | undefined;
     }
     interface SpawnSyncReturns<T> {
         pid: number;
@@ -1308,9 +1433,21 @@ declare module 'child_process' {
     function spawnSync(command: string, options: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns<Buffer>;
     function spawnSync(command: string, options?: SpawnSyncOptions): SpawnSyncReturns<string | Buffer>;
     function spawnSync(command: string, args: ReadonlyArray<string>): SpawnSyncReturns<Buffer>;
-    function spawnSync(command: string, args: ReadonlyArray<string>, options: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns<string>;
-    function spawnSync(command: string, args: ReadonlyArray<string>, options: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns<Buffer>;
-    function spawnSync(command: string, args?: ReadonlyArray<string>, options?: SpawnSyncOptions): SpawnSyncReturns<string | Buffer>;
+    function spawnSync(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnSyncOptionsWithStringEncoding,
+    ): SpawnSyncReturns<string>;
+    function spawnSync(
+        command: string,
+        args: ReadonlyArray<string>,
+        options: SpawnSyncOptionsWithBufferEncoding,
+    ): SpawnSyncReturns<Buffer>;
+    function spawnSync(
+        command: string,
+        args?: ReadonlyArray<string>,
+        options?: SpawnSyncOptions,
+    ): SpawnSyncReturns<string | Buffer>;
     interface CommonExecOptions extends CommonOptions {
         input?: string | NodeJS.ArrayBufferView | undefined;
         /**
@@ -1325,7 +1462,7 @@ declare module 'child_process' {
         stdio?: StdioOptions | undefined;
         killSignal?: NodeJS.Signals | number | undefined;
         maxBuffer?: number | undefined;
-        encoding?: BufferEncoding | 'buffer' | null | undefined;
+        encoding?: BufferEncoding | "buffer" | null | undefined;
     }
     interface ExecSyncOptions extends CommonExecOptions {
         shell?: string | undefined;
@@ -1334,7 +1471,7 @@ declare module 'child_process' {
         encoding: BufferEncoding;
     }
     interface ExecSyncOptionsWithBufferEncoding extends ExecSyncOptions {
-        encoding?: 'buffer' | null | undefined;
+        encoding?: "buffer" | null | undefined;
     }
     /**
      * The `child_process.execSync()` method is generally identical to {@link exec} with the exception that the method will not return
@@ -1363,7 +1500,7 @@ declare module 'child_process' {
         encoding: BufferEncoding;
     }
     interface ExecFileSyncOptionsWithBufferEncoding extends ExecFileSyncOptions {
-        encoding?: 'buffer' | null; // specify `null`.
+        encoding?: "buffer" | null; // specify `null`.
     }
     /**
      * The `child_process.execFileSync()` method is generally identical to {@link execFile} with the exception that the method will not
@@ -1390,10 +1527,18 @@ declare module 'child_process' {
     function execFileSync(file: string, options: ExecFileSyncOptionsWithBufferEncoding): Buffer;
     function execFileSync(file: string, options?: ExecFileSyncOptions): string | Buffer;
     function execFileSync(file: string, args: ReadonlyArray<string>): Buffer;
-    function execFileSync(file: string, args: ReadonlyArray<string>, options: ExecFileSyncOptionsWithStringEncoding): string;
-    function execFileSync(file: string, args: ReadonlyArray<string>, options: ExecFileSyncOptionsWithBufferEncoding): Buffer;
+    function execFileSync(
+        file: string,
+        args: ReadonlyArray<string>,
+        options: ExecFileSyncOptionsWithStringEncoding,
+    ): string;
+    function execFileSync(
+        file: string,
+        args: ReadonlyArray<string>,
+        options: ExecFileSyncOptionsWithBufferEncoding,
+    ): Buffer;
     function execFileSync(file: string, args?: ReadonlyArray<string>, options?: ExecFileSyncOptions): string | Buffer;
 }
-declare module 'node:child_process' {
-    export * from 'child_process';
+declare module "node:child_process" {
+    export * from "child_process";
 }