Skip to content

Processo atual ​

O namespace ambiente process descreve o programa Tyrus em execução. Esses valores estão disponíveis sem importar tyrus:process; esse módulo serve para iniciar e gerenciar processos filhos.

Referência da API ​

MembroTipo ou assinaturaDescrição
process.argvstring[]Argumentos de linha de comando. O índice 0 é o caminho do executável; os argumentos do usuário começam no índice 1.
process.pidu32Identificador do processo do programa em execução.
process.ppidu32Identificador do processo pai.
process.cwd()() => stringRetorna o diretório de trabalho atual.
process.uptime()() => u64Retorna o tempo de execução decorrido em milissegundos.
process.memoryUsage()() => MemoryInfoRetorna o uso de memória residente em bytes.
process.cpuUsage()() => CpuUsageRetorna o tempo de CPU acumulado do usuário e do sistema em microssegundos.
process.exit(code)(code: i32) => neverEncerra o programa com o código informado.

Argumentos de Linha de Comando ​

Argumentos depois de -- em tyrus run são passados ao programa, e não ao compilador. Array.at() retorna string?, então trate explicitamente um argumento que pode estar ausente.

tyrus
const main = (): void => {
    const args: string[] = process.argv.slice(1);
    const target: string = args.at(0) ?? "world";
    print(`hello ${target}`);
};

Como um programa Tyrus compilado é o próprio executável, o primeiro argumento do usuário fica no índice 1. Código portado de um runtime em que o índice 0 é um interpretador e o índice 1 é o script deve usar slice(1), e não slice(2).

Informações do Processo ​

process.memoryUsage() retorna este valor:

tyrus
interface MemoryInfo {
    readonly rss: u64;
}

rss é o tamanho residente do processo em bytes.

process.cpuUsage() retorna este valor:

tyrus
interface CpuUsage {
    readonly user: u64;
    readonly system: u64;
}

user e system são o tempo de CPU acumulado em microssegundos desde o início do processo, não porcentagens. Alvos Unix usam getrusage; no Windows, os contadores de 100 nanossegundos de GetProcessTimes são convertidos em microssegundos. Outros alvos retornam 0 nos dois campos.

tyrus
const main = (): void => {
    print(`pid ${process.pid}, ppid ${process.ppid}`);
    print(`running from ${process.cwd()}`);
    print(`up for ${process.uptime()}ms`);

    const memory = process.memoryUsage();
    print(`rss ${memory.rss} bytes`);

    const cpu = process.cpuUsage();
    print(`cpu ${cpu.user}us user, ${cpu.system}us system`);
};

process.exit(code) encerra o programa imediatamente, então statements depois dele são inalcançáveis. Um programa que retorna normalmente sai com o código 0.