networkSpeed

Mede o ping e a variação da rede atual com várias requisições.

API

networkSpeed

Retorna

Argumento	Descrição	Tipo
`Promise<ReturnType>`	Promessa resolvida com os resultados da medição	`Promise`

ReturnType

Propriedade	Descrição	Tipo
`ping`	Ping médio (milissegundos)	`number`
`jitter`	Variação da rede (milissegundos)	`number`

Parâmetros

Parâmetro	Descrição	Tipo	Padrão
`options`	Opções de configuração	`Options`	Obrigatório

Opções

Parâmetro	Descrição	Tipo	Padrão
`url`	URL da imagem usada na medição	`string`	Obrigatório
`duration`	Intervalo entre as requisições (ms)	`number`	`3000`
`count`	Número de medições	`number`	`5`

Exemplo

Uso básico

import { networkSpeed } from 'ranuts';

const result = await networkSpeed({
  url: 'https://example.com/test.jpg',
  count: 5,
  duration: 3000,
});

console.log('Latência média:', result.ping, 'ms');
console.log('Variação da rede:', result.jitter, 'ms');

Avaliar a qualidade da rede

import { networkSpeed } from 'ranuts';

async function assessNetwork() {
  const { ping, jitter } = await networkSpeed({ count: 10, url: 'https://example.com/test.jpg' });

  if (ping < 50 && jitter < 20) {
    console.log('Qualidade de rede excelente');
  } else if (ping < 100 && jitter < 50) {
    console.log('Qualidade de rede boa');
  } else {
    console.log('Qualidade de rede mediana');
  }
}

Mudar os parâmetros da medição

import { networkSpeed } from 'ranuts';

// Dez medições, com dois segundos entre cada uma
const result = await networkSpeed({
  url: 'https://example.com/ping.jpg',
  count: 10,
  duration: 2000,
});

Notas

Variação: descreve o quanto a rede oscila; é a diferença entre o maior e o menor valor de várias medições, e quanto menor, mais estável a rede.
Como mede: dispara várias requisições de imagem e calcula a latência média e a variação.
Valores padrão: cinco medições, com três segundos entre cada uma.
Quando usar: é comum para estimar a qualidade da rede, no monitoramento de desempenho e para afinar a experiência de uso.