Skip to content

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 ​

MembroAssinaturaFinalidade
pidu32Identificador do processo no sistema operacional.
stdinWritableStream<u8[]>Envia bytes para a entrada padrão.
stdoutReadableStream<u8[]>Recebe bytes da saída padrão.
stderrReadableStream<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.