Skip to content

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.

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