--- title: NavigatorOnLine.onLine slug: Web/API/NavigatorOnLine/onLine translation_of: Web/API/NavigatorOnLine/onLine ---

{{ApiRef("HTML DOM")}}

Возвращает сетевой статус браузера. Свойство возвращает логическое (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");})

Совместимость в браузерах

{{Compat("api.NavigatorOnLine.onLine")}}

Примечание

См Online/Offline события для более детального описания этого свойства, а также новых возможностей в автономном режимевведённых в Firefox 3.

Спецификация

Описана в рабочем проекте HTML 5

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