Network Information API

Schnittstellen

NetworkInformation

Bietet Informationen ber die Verbindung, die ein Gert zur Kommunikation mit dem Netzwerk verwendet, und ermglicht es Skripten, benachrichtigt zu werden, wenn sich der Verbindungstyp ndert. Die NetworkInformation-Schnittstelle kann nicht instanziiert werden. Sie wird stattdessen ber die Navigator-Schnittstelle oder die WorkerNavigator-Schnittstelle aufgerufen.

Erweiterungen zu anderen Schnittstellen

Navigator.connection Schreibgeschtzt

Gibt ein NetworkInformation-Objekt zurck, das Informationen ber die Netzwerkverbindung eines Gerts enthlt.

WorkerNavigator.connection Schreibgeschtzt

Bietet ein NetworkInformation-Objekt, das Informationen ber die Netzwerkverbindung eines Gerts enthlt.

Beispiele

Verbindungnderungen erkennen

Dieses Beispiel berwacht nderungen an der Verbindung des Benutzers.

let type = navigator.connection.effectiveType;

function updateConnectionStatus() {
  console.log(
    `Connection type changed from ${type} to ${navigator.connection.effectiveType}`,
  );
  type = navigator.connection.effectiveType;
}

navigator.connection.addEventListener("change", updateConnectionStatus);

Groe Ressourcen vorladen

Das Verbindungsobjekt ist ntzlich, um zu entscheiden, ob Ressourcen vorab geladen werden sollen, die viel Bandbreite oder Speicher bentigen. Dieses Beispiel wrde kurz nach dem Laden der Seite aufgerufen werden, um eine Verbindung zu berprfen, bei der das Vorladen eines Videos mglicherweise nicht wnschenswert ist. Wenn eine Mobilfunkverbindung erkannt wird, wird die preloadVideo-Flag auf false gesetzt. Zur Vereinfachung und Klarheit testet dieses Beispiel nur fr einen Verbindungstyp. Ein realer Anwendungsfall wrde wahrscheinlich eine Switch-Anweisung oder eine andere Methode verwenden, um alle mglichen Werte von NetworkInformation.type zu berprfen. Unabhngig vom type-Wert knnen Sie eine Schtzung der Verbindungsgeschwindigkeit ber die NetworkInformation.effectiveType-Eigenschaft erhalten.

let preloadVideo = true;
const connection = navigator.connection;
if (connection) {
  if (connection.effectiveType === "slow-2g") {
    preloadVideo = false;
  }
}

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Online- und Offline-Ereignisse