Skip to content

Proceso actual ​

El namespace ambiente process describe el programa Tyrus en ejecución. Estos valores están disponibles sin importar tyrus:process; ese módulo se usa para iniciar y administrar procesos hijos.

Referencia de la API ​

MiembroTipo o firmaDescripción
process.argvstring[]Argumentos de línea de comandos. El índice 0 es la ruta del ejecutable; los argumentos del usuario comienzan en el índice 1.
process.pidu32Identificador del proceso del programa en ejecución.
process.ppidu32Identificador del proceso padre.
process.cwd()() => stringDevuelve el directorio de trabajo actual.
process.uptime()() => u64Devuelve el tiempo de ejecución transcurrido en milisegundos.
process.memoryUsage()() => MemoryInfoDevuelve el uso de memoria residente en bytes.
process.cpuUsage()() => CpuUsageDevuelve el tiempo de CPU acumulado del usuario y del sistema en microsegundos.
process.exit(code)(code: i32) => neverFinaliza el programa con el código indicado.

Argumentos de Línea de Comandos ​

Los argumentos después de -- en tyrus run se pasan al programa, no al compilador. Array.at() devuelve string?, así que trata explícitamente los argumentos que podrían faltar.

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

Como un programa Tyrus compilado es el propio ejecutable, el primer argumento del usuario está en el índice 1. El código portado desde un runtime donde el índice 0 es un intérprete y el índice 1 es el script debe usar slice(1), no slice(2).

Información del Proceso ​

process.memoryUsage() devuelve este valor:

tyrus
interface MemoryInfo {
    readonly rss: u64;
}

rss es el tamaño residente del proceso en bytes.

process.cpuUsage() devuelve este valor:

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

user y system son el tiempo de CPU acumulado en microsegundos desde que inició el proceso, no porcentajes. Los objetivos Unix usan getrusage; Windows convierte los contadores de 100 nanosegundos de GetProcessTimes a microsegundos. Los demás objetivos devuelven 0 en ambos 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) finaliza el programa inmediatamente, así que las sentencias después de él son inalcanzables. Un programa que retorna normalmente sale con el código 0.