window.navigator.onLine

Renvoie l'état en ligne du navigateur. La propriété renvoie une valeur Booléenne, avec true signifiant en ligne et false signifiant hors ligne. La propriété envoie des mises à jour chaque fois que la capacité du navigateur à se connecter au réseau change. La mise à jour se produit lorsque l'utilisateur suit des liens ou lorsqu'un script demande une page distante. Par exemple, la propriété doit renvoyer false lorsque les utilisateurs cliquent sur des liens peu de temps après avoir perdu la connexion Internet.

Les navigateurs implémentent cette propriété différemment.

Dans Chrome et Safari, si le navigateur ne parvient pas à se connecter à un réseau local (LAN) ou à un routeur, il est hors ligne; toutes les autres conditions renvoient true. Ainsi, bien que vous puissiez supposer que le navigateur est hors ligne lorsqu'il renvoie une valeur false, vous ne pouvez pas supposer qu'une valeur vraie signifie nécessairement que le navigateur peut accéder à Internet. Vous pourriez obtenir de faux positifs, par exemple dans les cas où l'ordinateur exécute un logiciel de virtualisation doté d'adaptateurs Ethernet virtuels toujours «connectés». Par conséquent, si vous souhaitez vraiment déterminer l'état en ligne du navigateur, vous devez développer des moyens supplémentaires de vérification. Pour en savoir plus, consultez l'article HTML5 Rocks, Working Off the Grid.

Dans Firefox et Internet Explorer, le passage du navigateur en mode hors ligne envoie la valeur false. Jusqu'à Firefox 41, toutes les autres conditions renvoient une valeur vraie; tester le comportement réel sur Nightly 68 sous Windows montre qu'il ne recherche que la connexion LAN comme Chrome et Safari donnant de faux positifs.

Vous pouvez voir les changements dans l'état du réseau en écoutant les événements sur window.ononline et window.onoffline.

Syntaxe

window.navigator.onLine

Valeur

online est un Booléen true ou false.

Exemple

Voir un exemple en direct.

Pour vérifier si vous êtes en ligne, interrogez window.navigator.onLine, comme dans l'exemple suivant:

console.log(navigator.onLine ? 'online' : 'offline')

Si le navigateur ne prend pas en charge navigator.onLine, l'exemple ci-dessus apparaîtra toujours comme false / undefined.

Pour voir les modifications de l'état du réseau, utilisez addEventListener pour écouter les événements sur window.online et window.offline, comme dans l'exemple suivant:

window.addEventListener('offline', function(e) { ... })
window.addEventListener('offline', (e) => { ... })

window.addEventListener('online', function(e) { ... })
window.addEventListener('online', (e) => { ... })

Spécifications

Spécification État Commentaire
HTML Living Standard
La définition de 'navigator.onLine' dans cette spécification.
Standard évolutif Définition initiale

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
onLineChrome Support complet 1
Notes
Support complet 1
Notes
Notes Earlier versions of Chrome incorrectly return true when a tab is first opened, but it starts reporting the correct connectivity status after the first network event. Windows: 11, Mac: 14, Chrome OS: 13, Linux: Always returns true. For history, see crbug.com/7469.
Edge Support complet 12Firefox Support complet 3.5
Notes
Support complet 3.5
Notes
Notes Since Firefox 4 the browser returns true when 'Work Offline' mode is disabled and false when it is enabled, regardless of actual connectivity. Since Firefox 41, on OS X and Windows, the returned values follow the actual network connectivity, unless 'Work offline' mode is selected (where it will always return false).
IE Support complet 8
Notes
Support complet 8
Notes
Notes in Internet Explorer 8 'online' and 'offline' events are raised on the document.body; under IE 9 they are raised on both document.body and window.
Opera Support complet 3
Notes
Support complet 3
Notes
Notes From Opera 11.1 until Opera 12.1, the browser returns true when 'Work Offline' mode is disabled and false when it is enabled, regardless of actual connectivity.
Safari Support complet 5WebView Android Support complet 1
Notes
Support complet 1
Notes
Notes Faulty in a WebView component, see Issue bug 16760.
Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1
Notes
Support complet 10.1
Notes
Notes From Opera 11.1 until Opera 12.1, the browser returns true when 'Work Offline' mode is disabled and false when it is enabled, regardless of actual connectivity.
Safari iOS Support complet 4.2Samsung Internet Android Support complet 1.0

Légende

Support complet  
Support complet
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Notes

Voir Événements en ligne / hors ligne pour une description plus détaillée de cette propriété ainsi que des nouvelles fonctionnalités hors ligne introduites dans Firefox 3.

Voir également