@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
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: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
PromiseSpawnOptionsString
PromiseSpawnOptionsBuffer
PromiseSpawnOptionsStdin
PromiseSpawnOptionsNoStdin
PromiseSpawnOptionsStdout
PromiseSpawnOptionsNoStdout
PromiseSpawnOptionsStderr
PromiseSpawnOptionsNoStderr
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
SpawnResultString
SpawnResultBuffer
SpawnResultStdout
SpawnResultNoStdout
SpawnResultStderr
SpawnResultNoStderr
SpawnResultNoStdio
SpawnResultStdioStrings
SpawnResultStdioBuffers
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
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: null | Buffer
Defined in: index.ts:150
Overrides
stdout
stdout: null | Buffer
Defined in: index.ts:149
Overrides
SpawnResultNoStderr
Defined in: index.ts:173
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: null
Defined in: index.ts:174
Overrides
stdout
stdout: null | string | Buffer
Defined in: index.ts:141
Inherited from
SpawnResultNoStdio
Defined in: index.ts:176
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: null
Defined in: index.ts:177
Overrides
stdout
stdout: null
Defined in: index.ts:178
Overrides
SpawnResultNoStdout
Defined in: index.ts:161
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: null | string | Buffer
Defined in: index.ts:142
Inherited from
stdout
stdout: null
Defined in: index.ts:162
Overrides
SpawnResultStderr
Defined in: index.ts:164
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: string | Buffer
Defined in: index.ts:165
Overrides
stdout
stdout: null | string | Buffer
Defined in: index.ts:141
Inherited from
SpawnResultStderrBuffer
Defined in: index.ts:170
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: Buffer
Defined in: index.ts:171
Overrides
stdout
stdout: null | Buffer
Defined in: index.ts:149
Inherited from
SpawnResultStderrString
Defined in: index.ts:167
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: string
Defined in: index.ts:168
Overrides
stdout
stdout: null | string
Defined in: index.ts:145
Inherited from
SpawnResultStdioBuffers
Defined in: index.ts:184
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: Buffer
Defined in: index.ts:186
Overrides
stdout
stdout: Buffer
Defined in: index.ts:185
Overrides
SpawnResultStdioStrings
Defined in: index.ts:180
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: string
Defined in: index.ts:182
Overrides
stdout
stdout: string
Defined in: index.ts:181
Overrides
SpawnResultStdout
Defined in: index.ts:152
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: null | string | Buffer
Defined in: index.ts:142
Inherited from
stdout
stdout: string | Buffer
Defined in: index.ts:153
Overrides
SpawnResultStdoutBuffer
Defined in: index.ts:158
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: null | Buffer
Defined in: index.ts:150
Inherited from
stdout
stdout: Buffer
Defined in: index.ts:159
Overrides
SpawnResultStdoutString
Defined in: index.ts:155
Extends
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: null | string
Defined in: index.ts:146
Inherited from
stdout
stdout: string
Defined in: index.ts:156
Overrides
SpawnResultString
Defined in: index.ts:144
Extends
Extended by
Properties
args
args: string[];
Defined in: index.ts:137
Inherited from
command
command: string
Defined in: index.ts:136
Inherited from
cwd
cwd: string
Defined in: index.ts:138
Inherited from
signal
signal: null | Signals
Defined in: index.ts:140
Inherited from
status
status: null | number
Defined in: index.ts:139
Inherited from
stderr
stderr: null | string
Defined in: index.ts:146
Overrides
stdout
stdout: null | string
Defined in: index.ts:145
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: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
>