Возвращает сетевой статус браузера. Свойство возвращает логическое (boolean) значение, true означает online и false означает offline.Свойство обновляется всякий раз, когда способность браузера к подключению к сети изменится. Обновление происходит тогда, когда пользователь следует по ссылке или когда скрипт запрашивает удаленную страницу. Например, свойство должно вернуть false, когда пользователь кликает по ссылке, вскоре после потери подключения к интернету.
Браузеры реализуют это свойство по-разному.
В Chrome и Safari, если браузер не может соединиться с локальной сетью (LAN) или роутером, это будет означать offline; во всех остальных случаях вернется true.Таким образом, мы можем предположить что браузер не в сети, когда возвращаемое значение false, но вы не можете предположить что значение true обязательно обозначает что браузер может получить доступ к интернету. Вы можете получать ложные срабатывания, например, в случаях, когда компьютер под управлением программного обеспечения для виртуализации, которое имеет виртуальные сетевые адаптеры, которые всегда "Подключено". Поэтому, если вы действительно хотите, чтобы определять состояние браузера, вы должны разработать дополнительные средства проверки. Чтобы узнать больше, смотрите статью HTML5 Working Off the Grid.
В Firefox и Internet Explorer, переключение браузера в автономный режим посылает false значение. Во всех остальных случаях возвращается значение true.
Вы можете увидеть изменения в состоянии сети путем прослушивания событий window.ononline и window.onoffline.
Синтаксис
online = window.navigator.onLine;
Описание
online это логическое true или false.
Пример
Посмотрите на действующий пример.
Для проверки находитесь ли вы в сети, вызовите window.navigator.onLine, как показано в примере:
if (navigator.onLine) {
alert('online');
} else {
alert('offline');
}
Если браузер не поддерживает navigator.onLine в примере выше, то всегда будет false/undefined.
Чтобы увидеть изменения в состоянии сети, используйте addEventListener для прослушивания событий window.ononline и window.onoffline, как показано в примере:
window.addEventListener("offline", function(e) {alert("offline");})
window.addEventListener("online", function(e) {alert("online");})
Совместимость в браузерах
| свойство | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Базовая поддержка |
Windows: 11 [2] Просмотр истории crbug.com/7469 |
3.5 (1.9.1) [1] | 8 [3] | Нет [1] | 5.0.4 |
on WorkerNavigator |
? | 29 (29) | ? | ? | ? |
| Свойство | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile | BlackBerry |
|---|---|---|---|---|---|---|
| Базовая поддержка | Android 2.2 (Неисправность в компоненте WebView, см описание16760) | 1.0 (1.9.1) [1] | ? | ? | ? |
BlackBerry OS 7 |
on WorkerNavigator |
? | 29.0 (29) | ? | ? | ? | ? |
[1] Начиная с Firefox 4, и Opera 11.10, браузер возвращает true, когда режим "Работать автономно" отключен, и false, когда он включен, независимо от фактического подключения.
[2] Более ранние версии Chrome возвращали true неверно, когда вкладка открывается впервые, то он вначале сообщает правильный статус подключения после первого события сети.
[3] В IE 8 "online" и "offline" события находятся в document.body; Под IE 9 они оба находятся в document.body и window.
Примечание
См Online/Offline события для более детального описания этого свойства, а также новых возможностей в автономном режиме, введенных в Firefox 3.
Спецификация
Описана в рабочем проекте HTML 5