--- title: Navigator.onLine slug: Web/API/NavigatorOnLine/onLine translation_of: Web/API/NavigatorOnLine/onLine ---
Retorna el estado en línea del navegador. La propiedad retorna un valor booleano, true
significa en línea y false
significa desconectado. La propiedad envía actualizaciones siempre que el navegador tenga la capacidad de conectarse a los cambios de red. La actualización se produce cuando un usuario sigue un enlace o cuando un script pide una pagina remota. Por ejemplo, la propiedad debe retornar false
cuando los usuarios hacen clic en un enlace poco después de perder la conexión a internet.
Los navegadores implementan esta propiedad de forma diferente.
En Chrome y Safari, si el navegador no puede conectarse a la red de area local (LAN) o al router, está desconectado
; todas las otras condiciones retornan true
. Así que puedes suponer que el navegador esta desconectado cuando retorna un valor false
, no puedes suponer que un valor true
signifique que el navegador puede acceder a internet. Podrías estar recibiendo falsos positivos, como en los casos en el que el ordenador este ejecutando un software de virtualización que tiene los adaptadores ethernet virtuales siempre "conectados". Por lo tanto, si tu quieres determinar el estado en linea de el navegador, tu debes desarrollar medios adicionales para comprobarlo. Para más información, consulte el artículo HTML5 Rocks article, Working Off the Grid.
En Firefox e Internet Explorer, cambiando el navegador al modo desconectado envía un valor false
. Hasta Firefox 41, todas las demás condiciones retornaban un valor true
; desde Firefox 41, en OS X y Windows, el valor sigue la actual conectividad de red.
Puedes ver los cambios en el estado de red escuchando los eventos window.ononline y
window.onoffline.
online = window.navigator.onLine;
online
es booleano true
o false
.
Ver ejemplo en linea.
Para comprobar que estas es linea, consulte window.navigator.onLine
, como en el siguiente ejemplo:
if (navigator.onLine) { console.log('online'); } else { console.log('offline'); }
Si el navegador no soporta navigator.onLine
el ejemplo anterior siempre devolvera false
/undefined
.
Para ver los cambios en el estado de la red, use addEventListener
para escuchar los eventos window.ononline
y window.onoffline
, como en el siguiente ejemplo:
window.addEventListener('offline', function(e) { console.log('offline'); }); window.addEventListener('online', function(e) { console.log('online'); });
Especificación | Estado | Comentario |
---|---|---|
{{SpecName("HTML WHATWG", "browsers.html#navigator.online", "navigator.onLine")}} | {{Spec2("HTML WHATWG")}} | Initial definition |
{{CompatibilityTable}}
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}}[1] | {{CompatVersionUnknown}} | {{CompatGeckoDesktop(1.9.1)}}[2] {{CompatGeckoDesktop(2.0)}}[4] |
8[3] | {{CompatNo}}[2] | 5.0.4 |
on {{domxref("WorkerNavigator")}} | Yes | {{CompatUnknown}} | {{CompatGeckoDesktop(29)}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile | BlackBerry |
---|---|---|---|---|---|---|---|
Basic support | 2.2[5] | {{CompatVersionUnknown}} | {{CompatGeckoMobile(1.9.1)}}[2] | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
7 |
on {{domxref("WorkerNavigator")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatGeckoMobile(29)}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
[1] 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.
[2] Since Firefox 4, and Opera 11.10, the browser returns true
when "Work Offline" mode is disabled and false
when it is enabled, regardless of actual connectivity.
[3] 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
.
[4] 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
).
[5] Faulty in a WebView component, see Issue bug 16760.
See Online/Offline Events for a more detailed description of this property as well as new offline-related features introduced in Firefox 3.