Para desenvolvedores
Respostas em tempo real
Como ler o ping, que chega linha a linha, sem esperar o fim.
O ping em /api/ping responde aos poucos: cada linha chega assim que o servidor a recebe, no mesmo formato do ping do terminal.
Como ler
- Faça a requisição normalmente.
- Leia o corpo da resposta em pedaços (stream), sem esperar o fim.
- Para parar, cancele a requisição. O servidor encerra o ping na hora.
Exemplo no navegador
const res = await fetch("/api/ping?host=1.1.1.1");
const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
for (;;) {
const { done, value } = await reader.read();
if (done) break;
console.log(value);
}Formato da saída
PING 1.1.1.1 (1.1.1.1) 64 bytes from 1.1.1.1: icmp_seq=1 ttl=55 time=14.4 ms 64 bytes from 1.1.1.1: icmp_seq=2 ttl=55 time=14.7 ms
O ping para sozinho depois de 30 pacotes. Se o servidor não tiver ICMP, a medição usa o tempo de conexão TCP.
Atrás de um proxy como o nginx, desligue o buffering para essa rota, senão as linhas só chegam no fim.