window.navigator.onLine

概要

Returns the online status of the browser. The property returns a boolean value, with true for being online and false for being offline. The property sends updates whenever the browser's ability to connect to the network changes. The update occurs when the user follows links or when a script requests a remote page. For example, the property should return false when users click links soon after they lose internet connection.

Browsers implement this property differently.

In Chrome and Safari, if the browser is not able to connect to a local area network (LAN) or a router, it is offline; all other conditions return true. So while you can assume that the browser is offline when it returns a false value, you cannot assume that a true value necessarily means that the browser can access the internet. You could be getting false positives, such as in cases where the computer is running a virtualization software that has virtual ethernet adapters that are always "connected." Therefore, if you really want to determine the online status of the browser, you should develop additional means for checking. To learn more, see the HTML5 Rocks article, Working Off the Grid.

In Firefox and Internet Explorer, switching the browser to offline mode sends a false value. All other conditions return a true value.

You can see changes in the network state by listening for the events on window.onOnline and window.onOffline.

構文

online = window.navigator.onLine;

online is a boolean true or false.

View a live example.

To check if you are online, query window.navigator.onLine, as in the following example:

if (navigator.onLine) {
  alert('online')
} else {
  alert('offline');
}

If the browser doesn't support navigator.onLine the above example will always come out as falsy (false/undefined)

To see changes in the network state, listen (using addEventListener) for the for the events on window.onOnline and window.onOffline, as in the following example:

window.addEventListener("offline", function(e) {alert("offline");})

window.addEventListener("online", function(e) {alert("online");})

ブラウザ実装状況

機能 Chrome** Firefox (Gecko)* Internet Explorer Opera* Safari (WebKit)
基本サポート

Windows: 11
Mac: 14
Chrome OS: 13
Linux: Always returns true

For history, see crbug.com/7469

未サポート
バグ 336359
バグ 426932
バグ 620472

バグ 654579

8*** 未サポート 5.0.4
機能 Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
基本サポート Android 2.2 (Faulty in a WebView component, see Issue 16760) ? ? ? ?

* Firefox 4, and Opera 11.10 return true when "Work Offline" mode is disabled and false when it is enabled, regardless of actual connectivity.

** Earlier versions of Chrome incorrectly returns true when a tab is first opened, but it starts reporting the correct connectivity status after the first network event.

*** in IE 8 "online" and "ofline" events are raised on the document.body, under IE 9 - on both document.body and window

注記

See Online/Offline Events‎ for a more detailed description of this property as well as new offline-related features introduced in Firefox 3.

仕様

Described in the HTML 5 Working draft

関連情報

Document Tags and Contributors

Contributors to this page: ethertank, Potappo, Norah, Mgjbot
最終更新者: ethertank,