WorkerNavigator: onLine-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Gibt den Online-Status des Browsers zurück. Die Eigenschaft gibt einen booleschen Wert zurück, wobei true online und false offline bedeutet. Die Eigenschaft sendet Aktualisierungen, wann immer sich die Fähigkeit des Browsers, sich mit dem Netzwerk zu verbinden, ändert. Die Aktualisierung erfolgt, wenn der Benutzer Links folgt oder ein Skript eine entfernte Seite anfordert.

Zum Beispiel sollte die Eigenschaft false zurückgeben, wenn Benutzer auf Links klicken, kurz nachdem sie die Internetverbindung verloren haben.

Browser implementieren diese Eigenschaft unterschiedlich.

In Chrome und Safari ist der Browser offline, wenn er nicht in der Lage ist, eine Verbindung zu einem lokalen Netzwerk (LAN) oder einem Router herzustellen; alle anderen Bedingungen geben true zurück. Daher können Sie zwar davon ausgehen, dass der Browser offline ist, wenn ein false-Wert zurückgegeben wird, Sie können jedoch nicht annehmen, dass ein true-Wert notwendigerweise bedeutet, dass der Browser auf das Internet zugreifen kann. Es könnten Fehlalarme auftreten, beispielsweise in Fällen, in denen der Computer eine Virtualisierungssoftware ausführt, die virtuelle Ethernet-Adapter hat, die immer "verbunden" sind. Daher sollten Sie, wenn Sie den Online-Status des Browsers wirklich bestimmen möchten, zusätzliche Mittel zur Überprüfung entwickeln. Um mehr zu erfahren, siehe den Artikel von 2011, Working Off the Grid.

In Firefox sendet das Umschalten des Browsers in den Offline-Modus einen false-Wert.

Wert

online ist ein boolesches true oder false.

Beispiele

Grundlegende Verwendung

Um zu überprüfen, ob Sie in einem Worker online sind, fragen Sie navigator.onLine ab, wie im folgenden Beispiel:

js
if (navigator.onLine) {
  console.log("online");
} else {
  console.log("offline");
}

Wenn der Browser navigator.onLine nicht unterstützt, wird das obige Beispiel immer als false/undefined ausgegeben.

Lauschen auf Änderungen im Netzwerkstatus

Um Änderungen im Netzwerkzustand zu sehen, verwenden Sie addEventListener, um auf die Ereignisse online und offline zu lauschen, wie im folgenden Beispiel:

js
addEventListener("offline", (e) => {
  console.log("offline");
});

addEventListener("online", (e) => {
  console.log("online");
});

Spezifikationen

Specification
HTML Standard
# dom-navigator-online-dev

Browser-Kompatibilität

BCD tables only load in the browser