Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

ononline — gérer l’événement online

L’attribut ononline de body définit le code JavaScript qui gère l’événement online de l’objet Window. Il signale un changement dans l’évaluation par le navigateur de la disponibilité du réseau, mais ne confirme pas qu’un serveur particulier est joignable.

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

Syntaxe

<body ononline="JavaScript statements">

ononline est un attribut de contenu qui définit un gestionnaire pour l’événement online. Lorsqu’il est écrit sur body, il définit un gestionnaire sur Window au lieu de gérer un événement ordinaire ciblant body. Sa valeur est du code JavaScript ; le paramètre event disponible représente l’événement.

Le navigateur déclenche online lorsque navigator.onLine passe de false à true. Cela ne signifie pas qu’un serveur particulier est joignable ni qu’une requête réseau aboutira. Le simple fait d’enregistrer le gestionnaire ne l’appelle pas pour l’état initial de la connexion.

La propriété JavaScript correspondante est window.ononline. Lui affecter une valeur remplace le gestionnaire précédent de cette propriété. Une autre possibilité est window.addEventListener('online', handler), qui permet d’enregistrer des fonctions d’écoute indépendantes. N’insérez pas de données non fiables dans le code d’un attribut.

L’exemple déclenche volontairement un événement synthétique sur window afin de vérifier le branchement de l’attribut sans modifier la connexion. Le texte attendu dans le paragraphe est online. Ce test ne modifie pas navigator.onLine et ne prouve pas l’accès à Internet. Une Content Security Policy peut bloquer les gestionnaires écrits directement dans les attributs.

Exemples

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

Résultat

online

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources