Skip to content

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.

Assinaturatraceroute(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.