Skip to content

@vltpkg/promise-spawn

Classes

SpawnPromise<O, T>

Defined in: index.ts:228

Subtype of Promise returned by promiseSpawn.

Resolution value is inferred from the provided options.

Extends

Type Parameters

O extends PromiseSpawnOptions

T extends object = object

Constructors

new SpawnPromise()
new SpawnPromise<O, T>(
command,
args,
opts,
extra): SpawnPromise<O, T>

Defined in: index.ts:248

Parameters
command

string

args

string[]

opts

O

extra

T = ...

Returns

SpawnPromise<O, T>

Overrides
Promise<SpawnResultByOptions<O> & T>.constructor

Properties

[toStringTag]
[toStringTag]: string = 'SpawnPromise';

Defined in: index.ts:232

Overrides
Promise.[toStringTag]
process
process: ChildProcessByOptions<O>

Defined in: index.ts:235

The spawned process this promise references

stdin
stdin: O extends PromiseSpawnOptionsNoStdin ? null : Writable;

Defined in: index.ts:238

Expose the child process stdin, if available

Accessors

[species]
Get Signature
get static species: PromiseConstructor

Defined in: index.ts:244

Set static Symbol.species back to the base Promise class so that v8 doesn’t get confused by the changed constructor signature.

Returns

PromiseConstructor

Overrides
Promise.[species]

Interfaces

PromiseSpawnOptions

Defined in: index.ts:23

Extends

  • SpawnOptions

Extended by

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

stdioString?
optional stdioString: boolean;

Defined in: index.ts:24


PromiseSpawnOptionsBuffer

Defined in: index.ts:31

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptions.acceptFail

stdioString
stdioString: false

Defined in: index.ts:33

Overrides

PromiseSpawnOptions.stdioString


PromiseSpawnOptionsNoStderr

Defined in: index.ts:103

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptions.acceptFail

stdio
stdio:
| IOTypeNoPipe
| IOTypeNoPipe[]
| [number | IOType | "ipc" | Stream | null | undefined, number | IOType | "ipc" | Stream | null | undefined, IOTypeNoPipe];

Defined in: index.ts:105

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Overrides
PromiseSpawnOptions.stdio
stdioString?
optional stdioString: boolean;

Defined in: index.ts:24

Inherited from

PromiseSpawnOptions.stdioString


PromiseSpawnOptionsNoStdin

Defined in: index.ts:45

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptions.acceptFail

stdio
stdio:
| IOTypeNoPipe
| IOTypeNoPipe[]
| [number | IOTypeNoPipe, number | IOType | "ipc" | Stream | null | undefined, number | IOType | "ipc" | Stream | null | undefined];

Defined in: index.ts:47

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Overrides
PromiseSpawnOptions.stdio
stdioString?
optional stdioString: boolean;

Defined in: index.ts:24

Inherited from

PromiseSpawnOptions.stdioString


PromiseSpawnOptionsNoStdout

Defined in: index.ts:74

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptions.acceptFail

stdio
stdio:
| IOTypeNoPipe
| IOTypeNoPipe[]
| [number | IOType | "ipc" | Stream | null | undefined, IOTypeNoPipe | undefined, number | IOType | "ipc" | Stream | null | undefined];

Defined in: index.ts:76

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Overrides
PromiseSpawnOptions.stdio
stdioString?
optional stdioString: boolean;

Defined in: index.ts:24

Inherited from

PromiseSpawnOptions.stdioString


PromiseSpawnOptionsStderr

Defined in: index.ts:85

Extends

Extended by

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptions.acceptFail

stdio?
optional stdio:
| "overlapped"
| "pipe"
| [null | number | IOType | "ipc" | Stream, null | number | IOType | "ipc" | Stream, IOTypePipe];

Defined in: index.ts:87

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Overrides
PromiseSpawnOptions.stdio
stdioString?
optional stdioString: boolean;

Defined in: index.ts:24

Inherited from

PromiseSpawnOptions.stdioString


PromiseSpawnOptionsStderrBuffer

Defined in: index.ts:99

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptionsStderr.acceptFail

stdio?
optional stdio:
| "overlapped"
| "pipe"
| [null | number | IOType | "ipc" | Stream, null | number | IOType | "ipc" | Stream, IOTypePipe];

Defined in: index.ts:87

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Inherited from

PromiseSpawnOptionsStderr.stdio

stdioString
stdioString: false

Defined in: index.ts:101

Overrides

PromiseSpawnOptionsStderr.stdioString


PromiseSpawnOptionsStderrString

Defined in: index.ts:95

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptionsStderr.acceptFail

stdio?
optional stdio:
| "overlapped"
| "pipe"
| [null | number | IOType | "ipc" | Stream, null | number | IOType | "ipc" | Stream, IOTypePipe];

Defined in: index.ts:87

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Inherited from

PromiseSpawnOptionsStderr.stdio

stdioString?
optional stdioString: true;

Defined in: index.ts:97

Overrides

PromiseSpawnOptionsStderr.stdioString


PromiseSpawnOptionsStdin

Defined in: index.ts:35

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptions.acceptFail

stdio?
optional stdio:
| "overlapped"
| "pipe"
| [IOTypePipe, null | number | IOType | "ipc" | Stream, null | number | IOType | "ipc" | Stream];

Defined in: index.ts:37

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Overrides
PromiseSpawnOptions.stdio
stdioString?
optional stdioString: boolean;

Defined in: index.ts:24

Inherited from

PromiseSpawnOptions.stdioString


PromiseSpawnOptionsStdout

Defined in: index.ts:56

Extends

Extended by

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptions.acceptFail

stdio?
optional stdio:
| "overlapped"
| "pipe"
| [null | number | IOType | "ipc" | Stream, IOTypePipe, null | number | IOType | "ipc" | Stream];

Defined in: index.ts:58

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Overrides
PromiseSpawnOptions.stdio
stdioString?
optional stdioString: boolean;

Defined in: index.ts:24

Inherited from

PromiseSpawnOptions.stdioString


PromiseSpawnOptionsStdoutBuffer

Defined in: index.ts:70

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptionsStdout.acceptFail

stdio?
optional stdio:
| "overlapped"
| "pipe"
| [null | number | IOType | "ipc" | Stream, IOTypePipe, null | number | IOType | "ipc" | Stream];

Defined in: index.ts:58

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Inherited from

PromiseSpawnOptionsStdout.stdio

stdioString
stdioString: false

Defined in: index.ts:72

Overrides

PromiseSpawnOptionsStdout.stdioString


PromiseSpawnOptionsStdoutString

Defined in: index.ts:66

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptionsStdout.acceptFail

stdio?
optional stdio:
| "overlapped"
| "pipe"
| [null | number | IOType | "ipc" | Stream, IOTypePipe, null | number | IOType | "ipc" | Stream];

Defined in: index.ts:58

Can be set to ‘pipe’, ‘inherit’, ‘overlapped’, or ‘ignore’, or an array of these strings. If passed as an array, the first element is used for stdin, the second for stdout, and the third for stderr. A fourth element can be used to specify the stdio behavior beyond the standard streams. See ChildProcess.stdio for more information.

Default
'pipe'
Inherited from

PromiseSpawnOptionsStdout.stdio

stdioString?
optional stdioString: true;

Defined in: index.ts:68

Overrides

PromiseSpawnOptionsStdout.stdioString


PromiseSpawnOptionsString

Defined in: index.ts:27

Extends

Properties

acceptFail?
optional acceptFail: boolean;

Defined in: index.ts:25

Inherited from

PromiseSpawnOptions.acceptFail

stdioString?
optional stdioString: true;

Defined in: index.ts:29

Overrides

PromiseSpawnOptions.stdioString


SpawnResult

Defined in: index.ts:135

Extended by

Properties

args
args: string[];

Defined in: index.ts:137

command
command: string

Defined in: index.ts:136

cwd
cwd: string

Defined in: index.ts:138

signal
signal: null | Signals

Defined in: index.ts:140

status
status: null | number

Defined in: index.ts:139

stderr
stderr: null | string | Buffer

Defined in: index.ts:142

stdout
stdout: null | string | Buffer

Defined in: index.ts:141


SpawnResultBuffer

Defined in: index.ts:148

Extends

Extended by

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: null | Buffer

Defined in: index.ts:150

Overrides

SpawnResult.stderr

stdout
stdout: null | Buffer

Defined in: index.ts:149

Overrides

SpawnResult.stdout


SpawnResultNoStderr

Defined in: index.ts:173

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: null

Defined in: index.ts:174

Overrides

SpawnResult.stderr

stdout
stdout: null | string | Buffer

Defined in: index.ts:141

Inherited from

SpawnResult.stdout


SpawnResultNoStdio

Defined in: index.ts:176

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: null

Defined in: index.ts:177

Overrides

SpawnResult.stderr

stdout
stdout: null

Defined in: index.ts:178

Overrides

SpawnResult.stdout


SpawnResultNoStdout

Defined in: index.ts:161

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: null | string | Buffer

Defined in: index.ts:142

Inherited from

SpawnResult.stderr

stdout
stdout: null

Defined in: index.ts:162

Overrides

SpawnResult.stdout


SpawnResultStderr

Defined in: index.ts:164

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: string | Buffer

Defined in: index.ts:165

Overrides

SpawnResult.stderr

stdout
stdout: null | string | Buffer

Defined in: index.ts:141

Inherited from

SpawnResult.stdout


SpawnResultStderrBuffer

Defined in: index.ts:170

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResultBuffer.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResultBuffer.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResultBuffer.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResultBuffer.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResultBuffer.status

stderr
stderr: Buffer

Defined in: index.ts:171

Overrides

SpawnResultBuffer.stderr

stdout
stdout: null | Buffer

Defined in: index.ts:149

Inherited from

SpawnResultBuffer.stdout


SpawnResultStderrString

Defined in: index.ts:167

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResultString.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResultString.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResultString.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResultString.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResultString.status

stderr
stderr: string

Defined in: index.ts:168

Overrides

SpawnResultString.stderr

stdout
stdout: null | string

Defined in: index.ts:145

Inherited from

SpawnResultString.stdout


SpawnResultStdioBuffers

Defined in: index.ts:184

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: Buffer

Defined in: index.ts:186

Overrides

SpawnResult.stderr

stdout
stdout: Buffer

Defined in: index.ts:185

Overrides

SpawnResult.stdout


SpawnResultStdioStrings

Defined in: index.ts:180

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: string

Defined in: index.ts:182

Overrides

SpawnResult.stderr

stdout
stdout: string

Defined in: index.ts:181

Overrides

SpawnResult.stdout


SpawnResultStdout

Defined in: index.ts:152

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: null | string | Buffer

Defined in: index.ts:142

Inherited from

SpawnResult.stderr

stdout
stdout: string | Buffer

Defined in: index.ts:153

Overrides

SpawnResult.stdout


SpawnResultStdoutBuffer

Defined in: index.ts:158

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResultBuffer.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResultBuffer.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResultBuffer.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResultBuffer.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResultBuffer.status

stderr
stderr: null | Buffer

Defined in: index.ts:150

Inherited from

SpawnResultBuffer.stderr

stdout
stdout: Buffer

Defined in: index.ts:159

Overrides

SpawnResultBuffer.stdout


SpawnResultStdoutString

Defined in: index.ts:155

Extends

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResultString.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResultString.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResultString.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResultString.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResultString.status

stderr
stderr: null | string

Defined in: index.ts:146

Inherited from

SpawnResultString.stderr

stdout
stdout: string

Defined in: index.ts:156

Overrides

SpawnResultString.stdout


SpawnResultString

Defined in: index.ts:144

Extends

Extended by

Properties

args
args: string[];

Defined in: index.ts:137

Inherited from

SpawnResult.args

command
command: string

Defined in: index.ts:136

Inherited from

SpawnResult.command

cwd
cwd: string

Defined in: index.ts:138

Inherited from

SpawnResult.cwd

signal
signal: null | Signals

Defined in: index.ts:140

Inherited from

SpawnResult.signal

status
status: null | number

Defined in: index.ts:139

Inherited from

SpawnResult.status

stderr
stderr: null | string

Defined in: index.ts:146

Overrides

SpawnResult.stderr

stdout
stdout: null | string

Defined in: index.ts:145

Overrides

SpawnResult.stdout

Type Aliases

ChildProcessByOptions<T>

type ChildProcessByOptions<T> = Override<
ChildProcess,
{
stderr: T extends PromiseSpawnOptionsNoStderr ? null
: Exclude<ChildProcess['stderr'], null>
stdin: T extends PromiseSpawnOptionsNoStdin ? null
: Exclude<ChildProcess['stdin'], null>
stdout: T extends PromiseSpawnOptionsNoStdout ? null
: Exclude<ChildProcess['stdout'], null>
}
>

Defined in: index.ts:210

Type Parameters

T extends PromiseSpawnOptions


IOTypeNoPipe

type IOTypeNoPipe = Exclude<IOType, IOTypePipe>

Defined in: index.ts:20


IOTypePipe

type IOTypePipe = 'overlapped' | 'pipe' | null | undefined

Defined in: index.ts:21


Override<T, R>

type Override<T, R> = Omit<T, keyof R> & R

Defined in: index.ts:189

Type Parameters

T

R


SpawnResultByOptions<T>

type SpawnResultByOptions<T> = Override<
SpawnResult,
{
stderr: T extends PromiseSpawnOptionsNoStderr ? null
: T extends PromiseSpawnOptionsStderrBuffer ? Buffer
: T extends PromiseSpawnOptionsStderrString ? string
: T extends PromiseSpawnOptionsBuffer ? Buffer | null
: T extends PromiseSpawnOptionsString ? string | null
: Buffer | string | null
stdout: T extends PromiseSpawnOptionsNoStdout ? null
: T extends PromiseSpawnOptionsStdoutBuffer ? Buffer
: T extends PromiseSpawnOptionsStdoutString ? string
: T extends PromiseSpawnOptionsBuffer ? Buffer | null
: T extends PromiseSpawnOptionsString ? string | null
: Buffer | string | null
}
>

Defined in: index.ts:191

Type Parameters

T extends PromiseSpawnOptions

Functions

promiseSpawn()

function promiseSpawn<O, E>(
command,
args,
opts,
extra,
): SpawnPromise<O, E>

Defined in: index.ts:306

Spawn the specified command, and return a promise that resolves when the process closes or has an error.

Type Parameters

O extends PromiseSpawnOptions = PromiseSpawnOptionsStderrString & PromiseSpawnOptionsStdoutString

E extends object = object

Parameters

command

string

args

string[]

opts

O = ...

extra

E = ...

Returns

SpawnPromise<O, E>