You’re reading the English version of this content since no translation exists yet for this locale. Help us translate this article!
Document.online event is fired on the
<body> of each page when the browser switches between online and offline mode. Additionally, the events bubble up from
document, ending at
window. Both events are non-cancellable (you can't prevent the user from coming online, or going offline).
window.navigator.onLine returns boolean
true if the browser is online and
false if it is definitely offline (disconnected from the network). The
offline events are fired when the value of this attribute changes.
It is important to note that this event and attribute are inherently unreliable. A computer can be connected to a network without having Internet access.
You can register listeners for these events in a few familiar ways:
- By setting the
Functionobject. (Note: using
window.onofflinewill not work for compatibility reasons.)
- By specifying
onoffline="..."attributes on the
<body>tag in the HTML markup.
There's a simple test case that you can run to verify that the events are working.