— Pixels Commander

[:ru]OnlineJS — легковесная и простая библиотека для работы со статусом интернет — соединения[:en]OnlineJS — lightweight and easy to use library to check your internet connection status and react on it[:]

[:ru]При разработке мобильных Web приложений часто встречается задача определения статуса интернет — соединения, задача небольшая и каждый решает ее удобным для себя способом, Online JS — это надежная подборка лучших практик на тему, к тому же весьма небольшая по размеру и простая в использовании.

[:en]Detecting internet connection status with JavaScript is generic problem during mobile web applications or dynamic sites development and everybody solves it in his own way. Online JS is a compilation of best practices for detecting connection status, it`s reliable, fast, very lightweight and compatible with all popular frameworks library that is very easy to use.

[:][:ru]

Демо

Пользоваться библиотекой просто — добавьте online.min.js в проект и в любом удобном месте проверяйте:
window.onLine === true

Так же вы можете реагировать на подключение или отключение от интернета задав обработчики window.onLineHandler / window.offLineHandler.

Из оптимизаций используются:

• проверка соединения в фоновом режиме,
• запрос лишь заголовков для минимизации траффика,
• слушание событий online, offline, их дополнительная проверка.

Многие справшивают: «Почему бы не обойтись navigator.onLine для проверки соединения?». Про это свойство и его коварство написано немало. Главная проблема — свойство реализовано не консистентно среди браузеров и зачастую отражает лишь наличие подключения к локальной сети, а в некоторых версиях FireFox зависит только от включения / выключения режима автономного просмотра.

Чистый navigator.onLine для критически важных задач не подходит. А Online JS подходит, потому что использует это свойство и соответствующие события только как один из механизмов и затем перепроверяет статус соединения. Вы можете положиться на Online JS.

Репозиторий на GitHub[:en]

Simple example

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

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

Library uses such optimizations:

• checks status in background mode,
• requests only headers to minimize traffic,
• listens for window.online/offline events and verifies them.

P.S. I`m often asked: «Why library does not use navigator.onLine ?». This property is a bit underhandled and inconsistent between different browsers. For many of them it only shows status of local network connection and for some versions of FireFox it depends only on autonomic mode settings. So using this property in critical tasks is not good idea. Online JS is a right way for serious project because library uses navigator.onLine only as one of possible triggers and then makes more tests of internet connection status. You can rely on Online JS.

GitHub repository[:]