Skip to content

ChildProcess ​

ChildProcess posee un programa externo iniciado y expone sus descriptores estándar como streams separados por capacidad.

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>>;
}

Miembros ​

MiembroFirmaFinalidad
pidu32Identificador del proceso en el sistema operativo.
stdinWritableStream<u8[]>Envía bytes a la entrada estándar.
stdoutReadableStream<u8[]>Recibe bytes de la salida estándar.
stderrReadableStream<u8[]>Recibe bytes del error estándar.
wait()() => Promise<Result<i32, ProcessError>>Se resuelve con el código de salida o un error recuperable del proceso.
kill()() => Promise<Result<void, ProcessError>>Solicita la terminación e informa los fallos recuperables.

Uso y errores ​

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]); 
}

Cerrar stdin entrega EOF sin cerrar la salida. Los streams de salida y error permanecen legibles después de kill() para drenar bytes aceptados. Liberar el último handle termina y recolecta un hijo todavía en ejecución.