Check and react on network state of your progressive web app

Downloads in past


2.5.02 years ago6 years agoMinified + gzip package size for ember-network-state in KB


Build Status GitHub version NPM version Dependency Status codecov Greenkeeper badge Ember Observer Score FOSSA Status


  • Ember.js v3.20 or above
  • Ember CLI v3.20 or above
  • Node.js v12 or above

The browser provides network property window.navigator.onLine and events online and offline. The problem is that this API is not reliable, we can have an interface connection (phone is not on airplane mode, we have WiFi data) but the network may not have access to the internet.
In order to confirm the connection status, this addon pings a URL (by default it is the favicon.ico) when it detects that user supposedly have connectivity again. When the ping ends and it goes OK, it will switch to online state, but if ping doesn't go OK, this addon will keep the state limited and it will schedule a ping every certain time.
If the browser has implemented connection API, it will listen for changes on network quality as well.
Below is an example of all states of the service:


Install the addon with ember-cli.
ember install ember-network-state

Inject the service in your app:
export default class MyClass {
  @service network;



  • state: returns current state of the network. Possible values: ONLINE, OFFLINE and LIMITED. You can import values from:
import { STATES } from 'ember-network-state/constants';
  • remaining: returns remaining milliseconds to next reconnect.

  • isOnline: computed value from state that returns when is ONLINE.

  • isOffline: computed value from state that returns when is OFFLINE.

  • isLimited: computed value from state that returns when is LIMITED.

  • isReconnecting: checks when service is testing for connection.

  • hasTimer: checks when service has scheduled a timer.

  • lastReconnectDuration: saves last reconnect duration.

  • lastReconnectStatus: saves last reconnect status.


  • reconnect: you can call this method to force a reconnect request. Next delay will be multiplied as if it will reach countdown to zero.


You can subscribe to the change event to receive changes on state property.
const network = this.get('network');

network.on('change', (state) => {});


The addon can be configured in config/environment.js of your app.
module.exports = function (/* environment */) {
  return {
    'network-state': {
      reconnect: {
        auto: true,
        path: '/favicon.ico',
        delay: 5000,
        multiplier: 1.5,
        timeout: 15000,
        maxDelay: 60000,
        maxTimes: -1,

Posible values:
  • reconnect: Object to configure reconnect parameters.
- auto: Auto reconnects when network changes. - path: Path to request on reconnect. Default: /favicon.ico. - delay: Initial delay for retry a reconnection. Default: 5000. - multiplier: Increment for next retry. Next delay will be delay * multiplier. Default: 1.5. - timeout: Reconnect request timeout. - maxDelay: Maximum delay for a reconnect. Default: 60000. - maxTimes: Maximum times for a reconnect. When value is negative, its Infinity. Default: -1.


If you want to contribute to this addon, please read the CONTRIBUTING.md.


We use SemVer for versioning. For the versions available, see the tags on this repository.


See the list of contributors who participated in this project.


See the Contributing guide for details.


This project is licensed under the MIT License - see the LICENSE.md file for details
FOSSA Status