ChildProcess
ChildProcess possui um programa externo iniciado e expõe seus descritores padrão como streams separados por capacidade.
tyrus
interface ChildProcess {
readonly pid: u32;
readonly stdin: WritableStream<u8[]>;
readonly stdout: ReadableStream<u8[]>;
readonly stderr: ReadableStream<u8[]>;
wait(): Promise<Result<i32, ProcessError>>;
kill(): Promise<Result<void, ProcessError>>;
}Membros
| Membro | Assinatura | Finalidade |
|---|---|---|
pid | u32 | Identificador do processo no sistema operacional. |
stdin | WritableStream<u8[]> | Envia bytes para a entrada padrão. |
stdout | ReadableStream<u8[]> | Recebe bytes da saída padrão. |
stderr | ReadableStream<u8[]> | Recebe bytes do erro padrão. |
wait() | () => Promise<Result<i32, ProcessError>> | Resolve com o código de saída ou um erro recuperável do processo. |
kill() | () => Promise<Result<void, ProcessError>> | Solicita o encerramento e informa falhas recuperáveis. |
Uso e erros
tyrus
async function stop(child: ChildProcess): Promise<Result<i32, ProcessError>> {
const output: ReadableStream<u8[]> = child.stdout;
await child.stdin.close();
await child.kill()?;
return await child.wait();
}error
tyrus
async function invalid(child: ChildProcess): Promise<void> {
await child.stdout.write([1, 2, 3]);
}Fechar stdin entrega EOF sem fechar a saída. Os streams de saída e erro permanecem legíveis após kill() para drenar bytes aceitos. Liberar o último handle encerra e coleta um filho ainda em execução.
