@vltpkg/promise-spawn
Classes
SpawnPromise<O, T>
Defined in: index.ts:217
Subtype of Promise returned by promiseSpawn.
Resolution value is inferred from the provided options.
Extends
Promise<SpawnResultByOptions<O> &T>
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:237
Parameters
command
string
args
string[]
opts
O
extra
T = ...
Returns
SpawnPromise<O, T>
Overrides
Promise<SpawnResultByOptions<O> & T>.constructorProperties
[toStringTag]
[toStringTag]: string = 'SpawnPromise';Defined in: index.ts:221
Overrides
Promise.[toStringTag]process
process: ChildProcessByOptions<O>Defined in: index.ts:224
The spawned process this promise references
stdin
stdin: O extends PromiseSpawnOptionsNoStdin ? null : Writable;Defined in: index.ts:227
Expose the child process stdin, if available
Accessors
[species]
Get Signature
get static species: PromiseConstructorDefined in: index.ts:233
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:24
Extends
SpawnOptions
Extended by
PromiseSpawnOptionsStringPromiseSpawnOptionsBufferPromiseSpawnOptionsStdinPromiseSpawnOptionsNoStdinPromiseSpawnOptionsStdoutPromiseSpawnOptionsNoStdoutPromiseSpawnOptionsStderrPromiseSpawnOptionsNoStderr
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
stdioString?
optional stdioString: boolean;Defined in: index.ts:25
PromiseSpawnOptionsBuffer
Defined in: index.ts:31
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptions.acceptFail
stdioString
stdioString: falseDefined in: index.ts:32
Overrides
PromiseSpawnOptions.stdioString
PromiseSpawnOptionsNoStderr
Defined in: index.ts:93
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
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:94
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.stdiostdioString?
optional stdioString: boolean;Defined in: index.ts:25
Inherited from
PromiseSpawnOptions.stdioString
PromiseSpawnOptionsNoStdin
Defined in: index.ts:43
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
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:44
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.stdiostdioString?
optional stdioString: boolean;Defined in: index.ts:25
Inherited from
PromiseSpawnOptions.stdioString
PromiseSpawnOptionsNoStdout
Defined in: index.ts:68
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
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:69
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.stdiostdioString?
optional stdioString: boolean;Defined in: index.ts:25
Inherited from
PromiseSpawnOptions.stdioString
PromiseSpawnOptionsStderr
Defined in: index.ts:78
Extends
Extended by
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptions.acceptFail
stdio?
optional stdio: | "overlapped" | "pipe" | [null | number | IOType | "ipc" | Stream, null | number | IOType | "ipc" | Stream, IOTypePipe];Defined in: index.ts:79
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.stdiostdioString?
optional stdioString: boolean;Defined in: index.ts:25
Inherited from
PromiseSpawnOptions.stdioString
PromiseSpawnOptionsStderrBuffer
Defined in: index.ts:90
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptionsStderr.acceptFail
stdio?
optional stdio: | "overlapped" | "pipe" | [null | number | IOType | "ipc" | Stream, null | number | IOType | "ipc" | Stream, IOTypePipe];Defined in: index.ts:79
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: falseDefined in: index.ts:91
Overrides
PromiseSpawnOptionsStderr.stdioString
PromiseSpawnOptionsStderrString
Defined in: index.ts:87
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptionsStderr.acceptFail
stdio?
optional stdio: | "overlapped" | "pipe" | [null | number | IOType | "ipc" | Stream, null | number | IOType | "ipc" | Stream, IOTypePipe];Defined in: index.ts:79
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:88
Overrides
PromiseSpawnOptionsStderr.stdioString
PromiseSpawnOptionsStdin
Defined in: index.ts:34
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptions.acceptFail
stdio?
optional stdio: | "overlapped" | "pipe" | [IOTypePipe, null | number | IOType | "ipc" | Stream, null | number | IOType | "ipc" | Stream];Defined in: index.ts:35
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.stdiostdioString?
optional stdioString: boolean;Defined in: index.ts:25
Inherited from
PromiseSpawnOptions.stdioString
PromiseSpawnOptionsStdout
Defined in: index.ts:53
Extends
Extended by
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptions.acceptFail
stdio?
optional stdio: | "overlapped" | "pipe" | [null | number | IOType | "ipc" | Stream, IOTypePipe, null | number | IOType | "ipc" | Stream];Defined in: index.ts:54
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.stdiostdioString?
optional stdioString: boolean;Defined in: index.ts:25
Inherited from
PromiseSpawnOptions.stdioString
PromiseSpawnOptionsStdoutBuffer
Defined in: index.ts:65
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptionsStdout.acceptFail
stdio?
optional stdio: | "overlapped" | "pipe" | [null | number | IOType | "ipc" | Stream, IOTypePipe, null | number | IOType | "ipc" | Stream];Defined in: index.ts:54
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: falseDefined in: index.ts:66
Overrides
PromiseSpawnOptionsStdout.stdioString
PromiseSpawnOptionsStdoutString
Defined in: index.ts:62
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptionsStdout.acceptFail
stdio?
optional stdio: | "overlapped" | "pipe" | [null | number | IOType | "ipc" | Stream, IOTypePipe, null | number | IOType | "ipc" | Stream];Defined in: index.ts:54
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:63
Overrides
PromiseSpawnOptionsStdout.stdioString
PromiseSpawnOptionsString
Defined in: index.ts:28
Extends
Properties
acceptFail?
optional acceptFail: boolean;Defined in: index.ts:26
Inherited from
PromiseSpawnOptions.acceptFail
stdioString?
optional stdioString: true;Defined in: index.ts:29
Overrides
PromiseSpawnOptions.stdioString
SpawnResult
Defined in: index.ts:124
Extended by
SpawnResultStringSpawnResultBufferSpawnResultStdoutSpawnResultNoStdoutSpawnResultStderrSpawnResultNoStderrSpawnResultNoStdioSpawnResultStdioStringsSpawnResultStdioBuffers
Properties
args
args: string[];Defined in: index.ts:126
command
command: stringDefined in: index.ts:125
cwd
cwd: stringDefined in: index.ts:127
signal
signal: null | SignalsDefined in: index.ts:129
status
status: null | numberDefined in: index.ts:128
stderr
stderr: null | string | Buffer<ArrayBufferLike>Defined in: index.ts:131
stdout
stdout: null | string | Buffer<ArrayBufferLike>Defined in: index.ts:130
SpawnResultBuffer
Defined in: index.ts:137
Extends
Extended by
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: null | Buffer<ArrayBufferLike>Defined in: index.ts:139
Overrides
stdout
stdout: null | Buffer<ArrayBufferLike>Defined in: index.ts:138
Overrides
SpawnResultNoStderr
Defined in: index.ts:162
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: nullDefined in: index.ts:163
Overrides
stdout
stdout: null | string | Buffer<ArrayBufferLike>Defined in: index.ts:130
Inherited from
SpawnResultNoStdio
Defined in: index.ts:165
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: nullDefined in: index.ts:166
Overrides
stdout
stdout: nullDefined in: index.ts:167
Overrides
SpawnResultNoStdout
Defined in: index.ts:150
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: null | string | Buffer<ArrayBufferLike>Defined in: index.ts:131
Inherited from
stdout
stdout: nullDefined in: index.ts:151
Overrides
SpawnResultStderr
Defined in: index.ts:153
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: string | Buffer<ArrayBufferLike>Defined in: index.ts:154
Overrides
stdout
stdout: null | string | Buffer<ArrayBufferLike>Defined in: index.ts:130
Inherited from
SpawnResultStderrBuffer
Defined in: index.ts:159
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: BufferDefined in: index.ts:160
Overrides
stdout
stdout: null | Buffer<ArrayBufferLike>Defined in: index.ts:138
Inherited from
SpawnResultStderrString
Defined in: index.ts:156
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: stringDefined in: index.ts:157
Overrides
stdout
stdout: null | stringDefined in: index.ts:134
Inherited from
SpawnResultStdioBuffers
Defined in: index.ts:173
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: BufferDefined in: index.ts:175
Overrides
stdout
stdout: BufferDefined in: index.ts:174
Overrides
SpawnResultStdioStrings
Defined in: index.ts:169
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: stringDefined in: index.ts:171
Overrides
stdout
stdout: stringDefined in: index.ts:170
Overrides
SpawnResultStdout
Defined in: index.ts:141
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: null | string | Buffer<ArrayBufferLike>Defined in: index.ts:131
Inherited from
stdout
stdout: string | Buffer<ArrayBufferLike>Defined in: index.ts:142
Overrides
SpawnResultStdoutBuffer
Defined in: index.ts:147
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: null | Buffer<ArrayBufferLike>Defined in: index.ts:139
Inherited from
stdout
stdout: BufferDefined in: index.ts:148
Overrides
SpawnResultStdoutString
Defined in: index.ts:144
Extends
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: null | stringDefined in: index.ts:135
Inherited from
stdout
stdout: stringDefined in: index.ts:145
Overrides
SpawnResultString
Defined in: index.ts:133
Extends
Extended by
Properties
args
args: string[];Defined in: index.ts:126
Inherited from
command
command: stringDefined in: index.ts:125
Inherited from
cwd
cwd: stringDefined in: index.ts:127
Inherited from
signal
signal: null | SignalsDefined in: index.ts:129
Inherited from
status
status: null | numberDefined in: index.ts:128
Inherited from
stderr
stderr: null | stringDefined in: index.ts:135
Overrides
stdout
stdout: null | stringDefined in: index.ts:134
Overrides
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:199
Type Parameters
• T extends PromiseSpawnOptions
IOTypeNoPipe
type IOTypeNoPipe = Exclude<IOType, IOTypePipe>Defined in: index.ts:21
IOTypePipe
type IOTypePipe = 'overlapped' | 'pipe' | null | undefinedDefined in: index.ts:22
Override<T, R>
type Override<T, R> = Omit<T, keyof R> & RDefined in: index.ts:178
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:180
Type Parameters
• T extends PromiseSpawnOptions
Functions
promiseSpawn()
function promiseSpawn<O, E>( command, args, opts, extra,): SpawnPromise<O, E>Defined in: index.ts:316
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>