networkSpeed

Misst Ping und Schwankung des aktuellen Netzes über mehrere Anfragen.

API

networkSpeed

Rückgabe

Argument	Beschreibung	Typ
Promise<ReturnType>	Promise, das mit den Messergebnissen erfüllt wird	Promise

ReturnType

Eigenschaft	Beschreibung	Typ
ping	Mittlerer Ping (Millisekunden)	number
jitter	Schwankung des Netzes (Millisekunden)	number

Parameter

Parameter	Beschreibung	Typ	Standard
options	Einstellungen	Options	Erforderlich

Optionen

Parameter	Beschreibung	Typ	Standard
url	URL des Bildes, mit dem gemessen wird	string	Erforderlich
duration	Abstand zwischen den Anfragen (ms)	number	3000
count	Zahl der Messungen	number	5

Beispiel

Grundlegende Verwendung

import { networkSpeed } from 'ranuts';

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

console.log('Mittlere Latenz:', result.ping, 'ms');
console.log('Schwankung des Netzes:', result.jitter, 'ms');

Die Netzqualität einschätzen

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('Ausgezeichnete Netzqualität');
  } else if (ping < 100 && jitter < 50) {
    console.log('Gute Netzqualität');
  } else {
    console.log('Mittelmäßige Netzqualität');
  }
}

Die Messwerte anpassen

import { networkSpeed } from 'ranuts';

// Zehn Messungen im Abstand von je zwei Sekunden
const result = await networkSpeed({
  url: 'https://example.com/ping.jpg',
  count: 10,
  duration: 2000,
});

Hinweise

1. Schwankung: beschreibt, wie unruhig das Netz ist — der Abstand zwischen größtem und kleinstem Wert mehrerer Messungen; je kleiner, desto stabiler das Netz.
2. Messverfahren: schickt mehrere Bildanfragen und errechnet daraus die mittlere Latenz und die Schwankung.
3. Voreinstellung: fünf Messungen im Abstand von je drei Sekunden.
4. Einsatz: üblich, um die Netzqualität einzuschätzen, zur Leistungsüberwachung und zum Feinschliff der Nutzung.