WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

ononline — das online-Ereignis behandeln

Das Attribut ononline auf body legt JavaScript-Code fest, der das online-Ereignis des Window-Objekts behandelt. Es signalisiert eine Änderung der Einschätzung des Browsers zur Netzwerkverfügbarkeit, bestätigt aber nicht, dass ein bestimmter Server erreichbar ist.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<body ononline="JavaScript statements">

ononline ist ein Ereignisbehandlungsattribut für online. Wird es auf body angegeben, legt es einen Handler für Window fest und behandelt kein gewöhnliches Ereignis, das an body gerichtet ist. Der Attributwert ist JavaScript-Code; der verfügbare Parameter event steht für das Ereignis.

Der Browser löst online aus, wenn sich navigator.onLine von false zu true ändert. Das bedeutet weder, dass ein bestimmter Server erreichbar ist, noch, dass eine Netzwerkanfrage erfolgreich sein wird. Allein durch das Registrieren des Handlers wird er nicht für den anfänglichen Verbindungsstatus aufgerufen.

Die entsprechende JavaScript-Eigenschaft ist window.ononline. Eine Zuweisung an sie ersetzt den bisherigen Handler dieser Eigenschaft. Eine Alternative ist window.addEventListener('online', handler), womit sich unabhängige Listener-Funktionen registrieren lassen. Füge keine nicht vertrauenswürdigen Daten in Attributcode ein.

Das Beispiel löst absichtlich ein synthetisches Ereignis auf window aus, um die Zuordnung des Attributs zu prüfen, ohne die Verbindung zu ändern. Der erwartete Absatztext lautet online. Dieser Test ändert navigator.onLine nicht und beweist keinen Internetzugang. Eine Content Security Policy kann Handler blockieren, die direkt in Attributen stehen.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ononline demo</title>
</head>
<body ononline="document.getElementById('status').textContent = event.type">
  <p id="status">waiting</p>
  <script>
    window.dispatchEvent(new Event('online'));
  </script>
</body>
</html>

Ergebnis

online

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.

Quellen