Skip to content

ping ​

ping envia uma requisição ICMP Echo e retorna o tempo de ida e volta em milissegundos dentro de Ok; falhas recuperáveis da sondagem retornam como Err(NetError).

A função está disponível quando supportsIcmp() retorna true. Ela é implementada no Linux, macOS e Windows e retorna Err(NetError) quando a plataforma ou sandbox não oferece a capacidade necessária. O macOS exige permissão para abrir um socket ICMP raw.

Assinaturaping(address: string, timeoutMs?: u64): Promise<Result<u64, NetError>>
tyrus
import { NetError, ping, supportsIcmp } from "tyrus:net";

async function measure(): Promise<void> {
    if (supportsIcmp()) {
        const result: Result<u64, NetError> = await ping("127.0.0.1", 1000);
        match (result) {
            Ok(milliseconds) => { print(milliseconds); } // 0
            Err(error) => { printError(error.code); } // ERR_NET_TIMEOUT
        }
    }
}

Tratamento de erro ​

error

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

async function measure(): Promise<void> {
    const result: Result<u64, NetError> = await ping("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.