networkSpeed

Mide el ping y la fluctuación de la red actual con varias peticiones.

API

networkSpeed

Devuelve

Argumento	Descripción	Tipo
Promise<ReturnType>	Promesa que se resuelve con los resultados de la medición	Promise

ReturnType

Propiedad	Descripción	Tipo
ping	Ping medio (milisegundos)	number
jitter	Fluctuación de la red (milisegundos)	number

Parámetros

Parámetro	Descripción	Tipo	Por defecto
options	Opciones de configuración	Options	Obligatorio

Opciones

Parámetro	Descripción	Tipo	Por defecto
url	URL de la imagen con la que se mide	string	Obligatorio
duration	Intervalo entre peticiones (ms)	number	3000
count	Número de mediciones	number	5

Ejemplo

Uso básico

import { networkSpeed } from 'ranuts';

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

console.log('Latencia media:', result.ping, 'ms');
console.log('Fluctuación de la red:', result.jitter, 'ms');

Valorar la calidad de la red

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('Calidad de red excelente');
  } else if (ping < 100 && jitter < 50) {
    console.log('Calidad de red buena');
  } else {
    console.log('Calidad de red normal');
  }
}

Cambiar los parámetros de la medición

import { networkSpeed } from 'ranuts';

// Diez mediciones, con dos segundos entre cada una
const result = await networkSpeed({
  url: 'https://example.com/ping.jpg',
  count: 10,
  duration: 2000,
});

Notas

1. Fluctuación: describe lo inestable que es la red; es la diferencia entre el valor máximo y el mínimo de varias mediciones, y cuanto menor sea, más estable es la red.
2. Cómo mide: lanza varias peticiones de imagen y calcula la latencia media y la fluctuación.
3. Valores por defecto: cinco mediciones con tres segundos entre cada una.
4. Cuándo usarlo: es habitual para estimar la calidad de la red, en monitorización de rendimiento y para afinar la experiencia de uso.