ONLINE JS

Lightweight and reliable library to check internet connection status.

Compatible browsers: IE 8-11, Opera, Chrome, Firefox, Android, iOS

Usage

Include this library into your project and just check is window.onLine === true.

Assign window.onLineHandler or window.offLineHandler functions to handle status changes.

Just look at example (index.html in the repo)!

More info in this blog post.

Safety and guarantees

Library requests headers from public URL to check if internet is available. URL set by default is maintained by me and there is no guarantee I am going to run it forever. In order to make it safe for your application it is recommended to run your own URL responding with header Access-Control-Allow-Origin: * and then switch Online.JS to it by setting window.onLineURL.

navigator.onLine

I`m often asked: “Why not just use navigator.onLine ?”. Using this property in critical tasks is bad idea. Property is underhandled and is not consistent among all browsers. It can show local connection status or react only on autonomous mode switching. Online JS is better way for serious project, it uses navigator.onLine and corresponding events as one of possible triggers and then makes more checks of internet connection.

Questions and propositions

Feel free to write me with any questions or propositions [email protected]

Bug tracker

Have a bug? Please create an issue here on GitHub!

https://github.com/PixelsCommander/OnlineJS/issues

Twitter account

Keep up to date on announcements and more by following OnlineJS on Twitter, @pixelscommander.

License

Copyright 2011 Denis Radin.

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0