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:
addEventListener
on the window
, document
, or document.body
.ononline
or .onoffline
properties on document
or document.body
to a JavaScript Function
object. (Note: using window.ononline
or window.onoffline
will not work for compatibility reasons.)ononline="..."
or 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.
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/ononline