ping
ping envía una solicitud ICMP Echo y devuelve el tiempo de ida y vuelta en milisegundos dentro de Ok; los fallos recuperables de la sonda se devuelven como Err(NetError).
La función está disponible cuando supportsIcmp() devuelve true. Está implementada en Linux, macOS y Windows y devuelve Err(NetError) cuando la plataforma o el sandbox no ofrecen la capacidad necesaria. macOS requiere permiso para abrir un socket ICMP raw.
Firma
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
}
}
}Manejo de errores
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
}
}Los fallos usan ERR_NET_INVALID_ADDRESS, ERR_NET_PERMISSION, ERR_NET_TIMEOUT o ERR_NET_UNSUPPORTED.
