Navigator: onLine-Eigenschaft

Gibt den Online-Status des Browsers zurück. Die Eigenschaft gibt einen booleschen Wert zurück, wobei true online bedeutet und false offline. Die Eigenschaft sendet Updates, wann immer sich die Fähigkeit des Browsers ändert, eine Verbindung zum Netzwerk herzustellen. Das Update erfolgt, wenn der Benutzer Links folgt oder wenn 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 keine Verbindung zu einem lokalen Netzwerk (LAN) oder Router herstellen kann; alle anderen Bedingungen geben true zurück. Auch wenn Sie davon ausgehen können, dass der Browser offline ist, wenn er false zurückgibt, können Sie nicht davon ausgehen, dass ein true-Wert unbedingt bedeutet, dass der Browser auf das Internet zugreifen kann. Es könnte zu falschen Positiven kommen, wie in Fällen, in denen der Computer eine Virtualisierungssoftware ausführt, die virtuelle Ethernet-Adapter hat, die immer „verbunden“ sind. Wenn Sie den Online-Status des Browsers wirklich feststellen möchten, sollten Sie zusätzliche Mittel zur Prüfung entwickeln.

In Firefox sendet das Umschalten des Browsers in den Offline-Modus einen false-Wert. Bis Firefox 41 gaben alle anderen Bedingungen true zurück; Tests des tatsächlichen Verhaltens auf Nightly 68 unter Windows zeigen, dass er nur nach einer LAN-Verbindung sucht, ähnlich wie Chrome und Safari, was zu falschen Positiven führen kann.

Sie können Änderungen im Netzwerkstatus sehen, indem Sie die online und offline Ereignisse abhören.

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

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

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