NetworkInformation

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Das NetworkInformation Interface der Network Information API liefert Informationen über die Verbindung, die ein Gerät zur Kommunikation mit dem Netzwerk nutzt, und bietet eine Möglichkeit für Skripte, benachrichtigt zu werden, wenn sich der Verbindungstyp ändert. Das NetworkInformation Interface kann nicht instanziiert werden. Stattdessen wird es über die connection Eigenschaft des Navigator Interfaces oder des WorkerNavigator Interfaces aufgerufen.

EventTarget NetworkInformation

Instanzeigenschaften

Dieses Interface erbt auch Eigenschaften seines Elternteils, EventTarget.

Gibt die effektive Bandbreitenschätzung in Megabit pro Sekunde zurück, gerundet auf das nächste Vielfache von 25 Kilobit pro Sekunde.

NetworkInformation.downlinkMax Schreibgeschützt Experimentell

Gibt die maximale Downlink-Geschwindigkeit in Megabit pro Sekunde (Mbps) für die zugrunde liegende Verbindungstechnologie zurück.

NetworkInformation.effectiveType Schreibgeschützt

Gibt den effektiven Verbindungstyp zurück, der einer der folgenden sein kann: 'slow-2g', '2g', '3g' oder '4g'. Dieser Wert wird unter Verwendung einer Kombination aus kürzlich beobachteten Round-Trip-Zeiten und Downlink-Werten bestimmt.

NetworkInformation.rtt Schreibgeschützt

Gibt die geschätzte effektive Round-Trip-Zeit der aktuellen Verbindung zurück, gerundet auf das nächste Vielfache von 25 Millisekunden.

NetworkInformation.saveData Schreibgeschützt

Gibt true zurück, wenn der Nutzer eine Option zur reduzierten Datennutzung im User-Agent eingestellt hat.

NetworkInformation.type Schreibgeschützt Experimentell

Gibt den Verbindungstyp zurück, den ein Gerät zur Kommunikation mit dem Netzwerk verwendet. Er wird einen der folgenden Werte haben:

  • bluetooth
  • cellular
  • ethernet
  • none
  • wifi
  • wimax
  • other
  • unknown

Instanzmethoden

Dieses Interface erbt auch Methoden seines Elternteils, EventTarget.

Events

change

Das Event, das ausgelöst wird, wenn sich die Verbindungsinformationen ändern.

Spezifikationen

Specification
Network Information API
# networkinformation-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
NetworkInformation
change event
downlink
downlinkMax
Experimental
effectiveType
rtt
saveData
type
Experimental
typechange event
DeprecatedNon-standard
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.

Siehe auch