Skip to content

supportsIcmp ​

supportsIcmp informa se o ambiente atual permite os sockets necessários para ping e traceroute.

No Linux, o resultado verifica as duas capacidades de socket. No macOS, verifica se um socket ICMP raw pode ser aberto. No Windows, verifica se o identificador ICMP nativo do IP Helper pode ser aberto. Em plataformas não suportadas ou sandboxes restritas, retorna false.

AssinaturasupportsIcmp(): boolean
tyrus
import { supportsIcmp } from "tyrus:net";

if (supportsIcmp()) {
    print("network probes available"); // "network probes available"
}

Tratamento de erro ​

error

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

async function probe(): Promise<void> {
    if (!supportsIcmp()) {
        print("ERR_NET_UNSUPPORTED"); // "ERR_NET_UNSUPPORTED"
        return;
    }
    await ping("127.0.0.1");
}

A verificação de capacidade não lança erros. ping e traceroute cumprem com Err(NetError) usando ERR_NET_UNSUPPORTED quando ela retorna false.