Document.ononline
The 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.body
, to 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 online
and offline
events are fired when the value of this attribute changes.
Note: 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:
- Using
addEventListener
on thewindow
,document
, ordocument.body
- By setting the
.ononline
or.onoffline
properties ondocument
ordocument.body
to a JavaScriptFunction
object. (Note: usingwindow.ononline
orwindow.onoffline
will not work for compatibility reasons.) - By specifying
ononline="..."
oronoffline="..."
attributes on the<body>
tag in the HTML markup.
Example
There's a simple test case that you can run to verify that the events are working.