traceroute
traceroute informa saltos IPv4 que respondem dentro de Ok; Linux e macOS usam sondagens UDP com TTL crescente e recebem respostas ICMP, enquanto Windows usa sondagens ICMP Echo com TTL crescente. Falhas recuperáveis da sondagem retornam como Err(NetError).
O resultado contém no máximo 30 saltos. Um salto que não responde até o timeout é representado por "*". A função está disponível quando supportsIcmp() retorna true. O macOS exige permissão para abrir um socket ICMP raw.
Assinatura
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
}
}
}Tratamento de erro
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
}
}Falhas usam ERR_NET_INVALID_ADDRESS, ERR_NET_PERMISSION, ERR_NET_TIMEOUT ou ERR_NET_UNSUPPORTED.
