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
addEventListener
surwindow
,document
oudocument.body
- en définissant les propriétés
.ononline
ou.onoffline
surdocument
oudocument.body
sur un objetFunction
JavaScript. (Note : l'utilisation dewindow.ononline
ouwindow.onoffline
ne 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.