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.
Firma
traceroute(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.
