KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

ononline — de online-gebeurtenis afhandelen

Het attribuut ononline op body specificeert JavaScript-code die de online-gebeurtenis van het Window-object afhandelt. Het geeft een verandering aan in de beoordeling door de browser van de netwerkbeschikbaarheid, maar bevestigt niet dat een bepaalde server bereikbaar is.

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

Syntax

<body ononline="JavaScript statements">

ononline is een contentattribuut voor een gebeurtenishandler voor online. Wanneer het op body staat, stelt het een handler op Window in, in plaats van een gewone gebeurtenis af te handelen die op body is gericht. De waarde is JavaScript-code; de beschikbare parameter event stelt de gebeurtenis voor.

De browser activeert online wanneer navigator.onLine verandert van false naar true. Dit betekent niet dat een bepaalde server bereikbaar is of dat een netwerkaanvraag zal slagen. Alleen het registreren van de handler roept deze niet aan voor de aanvankelijke verbindingsstatus.

De bijbehorende JavaScript-eigenschap is window.ononline. Een toewijzing eraan vervangt de eerdere handler van die eigenschap. Een alternatief is window.addEventListener('online', handler), waarmee onafhankelijke listenerfuncties kunnen worden geregistreerd. Voeg geen niet-vertrouwde gegevens in attribuutcode in.

Het voorbeeld verstuurt bewust een synthetische gebeurtenis naar window om de koppeling van het attribuut te controleren zonder de verbinding te wijzigen. De verwachte tekst in de alinea is online. Deze test verandert navigator.onLine niet en bewijst geen internettoegang. Een Content Security Policy kan handlers blokkeren die rechtstreeks in attributen staan.

Voorbeelden

<!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>

Resultaat

online

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen