Skip to content

traceroute ​

traceroute informa los saltos IPv4 que responden dentro de Ok; Linux y macOS usan sondas UDP con TTL creciente y reciben respuestas ICMP, mientras que Windows usa sondas ICMP Echo con TTL creciente. Los fallos recuperables de la sonda se devuelven como Err(NetError).

El resultado contiene como máximo 30 saltos. Un salto que no responde antes del timeout se representa con "*". La función está disponible cuando supportsIcmp() devuelve true. macOS requiere permiso para abrir un socket ICMP raw.

Firmatraceroute(address: string, timeoutMs?: u64): Promise<Result<string[], NetError>>
tyrus
import { NetError, supportsIcmp, traceroute } from "tyrus:net";

async function trace(): Promise<void> {
    if (supportsIcmp()) {
        const result: Result<string[], NetError> = await traceroute("127.0.0.1", 1000);
        match (result) {
            Ok(hops) => { print(hops.length); } // 1
            Err(error) => { printError(error.code); } // ERR_NET_TIMEOUT
        }
    }
}

Manejo de errores ​

error

tyrus
import { NetError, traceroute } from "tyrus:net";

async function trace(): Promise<void> {
    const result: Result<string[], NetError> = await traceroute("invalid host\n", 1000);
    match (result) {
        Ok(_) => {}
        Err(error) => { printError(error.code); } // ERR_NET_RESOLVE
    }
}

Los fallos usan ERR_NET_INVALID_ADDRESS, ERR_NET_PERMISSION, ERR_NET_TIMEOUT o ERR_NET_UNSUPPORTED.