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.
Assinatura
ping(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.
