NavigatorOnLine.onLine

Возвращает сетевой статус браузера. Свойство возвращает логическое (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]
Mac: 14
Chrome OS: 13
Linux: всегда возвращает true

Просмотр истории 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
BlackBerry OS 10

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

Смотрите также

Метки документа и участники

 Внесли вклад в эту страницу: AlexAlex
 Обновлялась последний раз: AlexAlex,