CKTIS / HTML
onoffline – das Offline-Ereignis behandeln
Das Attribut onoffline auf body legt einen Handler für das offline-Ereignis des Window-Objekts fest. Damit kann eine Seite reagieren, wenn der Browser einen Verbindungsverlust meldet. Ob ein bestimmter Server erreichbar ist, wird dadurch jedoch nicht geprüft.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onoffline="JavaScript statements">onoffline ist ein Ereignisbehandlungsattribut: Sein Wert ist JavaScript-Code, kein boolescher Wert. Auf body behandelt es das offline-Ereignis des Window-Objekts und kein Ereignis, das nur das Element body betrifft.
Der Browser stellt ein offline-Ereignis in die Warteschlange, wenn sich navigator.onLine von true zu false ändert. Das Setzen des Attributs prüft nicht den Anfangszustand. Lies navigator.onLine bei der Initialisierung aus; für die entgegengesetzte Änderung kannst du ononline verwenden.
Dieses Signal prüft nicht, ob ein Server erreichbar ist. Der Wert true garantiert keinen Internetzugang, und Fehler bei Anfragen müssen unabhängig davon behandelt werden. Deaktiviere wichtige Funktionen nicht allein aufgrund dieses Indikators.
Eine Alternative zum Attribut ist window.addEventListener('offline', handler). Damit wird JavaScript vom HTML getrennt und es können mehrere Listener registriert werden. Eine Content Security Policy kann Handler-Code blockieren, der direkt in einem Attribut steht.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onoffline demonstration</title>
</head>
<body onoffline="document.getElementById('status').textContent = 'offline event received'">
<p id="status" role="status">waiting</p>
<button id="simulate" type="button">Simulate offline event</button>
<script>
document.getElementById('simulate').addEventListener('click', () => {
window.dispatchEvent(new Event('offline'));
});
</script>
</body>
</html>Ergebnis
offline event received
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.