Skip to content

ProcessError ​

ProcessError é o tipo estruturado de erro para falhas recuperáveis de processo.

Assinaturainterface ProcessError { readonly code: string; readonly message: string }

ProcessError é um valor Error e pode ser lançado por funções definidas pelo usuário. A API nativa exec o retorna na variante Err de Result<ChildProcess, ProcessError>.

Campos ​

CampoTipoFinalidade
codestringIdentificador estável ERR_PROCESS_*.
messagestringExplicação legível.

Uso e erros ​

tyrus
import { ChildProcess, ProcessError, exec } from "tyrus:process";

async function run(command: string): Promise<Result<i32, ProcessError>> {
    const child: ChildProcess = exec(command)?;
    return await child.wait();
}

error

tyrus
const child: ChildProcess = exec(42); 

Falhas de início incluem argumentos inválidos, pipes indisponíveis, um arquivo que o programa não tem permissão de executar (ERR_PROCESS_PERMISSION_DENIED) e um executável que não pode iniciar por qualquer outro motivo, como um comando que não existe (ERR_PROCESS_SPAWN_FAILED). Código de saída diferente de zero e bytes em stderr são resultados normais, não valores ProcessError.