Un évènement "online" est lancé sur le <body> (corps) de chaque page quand le navigateur bascule entre les modes online (en ligne) et offline (hors ligne). De plus les évènements se propagent de document.body vers document et finalement sur window. Les deux évènements ne sont pas annulables (vous ne pouvez pas empêcher l'utilisateur de se connecter ou de vous déconnecter).
window.navigator.onLine renvoie un booléen true (vrai) si le navigateur est online et false s'il est définitivement offline (déconnecté du réseau). Les évènements online et offline sont lancés si la valeur de cet attribut change.
Il est important de noter que cet événement et cet attribut sont intrinsèquement peu fiables. Un ordinateur peut être connecté à un réseau sans avoir accès à Internet.
Vous pouvez enregistrer les écouteurs de ces événements de plusieurs manières habituelles :
- en utilisant
addEventListenersurwindow,documentoudocument.body - en définissant les propriétés
.ononlineou.onofflinesurdocumentoudocument.bodysur un objetFunctionJavaScript. (Note : l'utilisation dewindow.ononlineouwindow.onofflinene fonctionnera pas pour des raisons de compatibilité). - en spécifiant les attributs
ononline="..."ouonoffline="..."sur la balise<body>dans le balisage HTML.
Exemple
Il existe un cas de test simple que vous pouvez exécuter pour vérifier le fonctionnement des évènements.