is-offline

A tiny (174B) library to detect `offline` status & respond to changes in the browser.

Usage no npm install needed!

<script type="module">
  import isOffline from 'https://cdn.skypack.dev/is-offline';
</script>

README

is-offline Build Status

A tiny (174B) library to detect offline status & respond to changes in the browser.

This module exposes three module definitions:

  • ES Module: dist/is-offline.es.js
  • CommonJS: dist/is-offline.js
  • UMD: dist/is-offline.min.js

If using the UMD bundle, the library is exposed as is-offline globally.

Install

$ npm install --save is-offline

Usage

import { check, watch } from 'is-offline';

let foobar = bool => console.log('Am I offline?', bool);

// Check if currently offline
check().then(foobar);

// Setup a "watcher" to respond to all online/offline changes
let unwatch = watch(foobar);

// The "watcher" will be active until it's deactivated
unwatch();

API

isOffline.check()

Returns: Promise

Resolves a Boolean to indicate offline status. For clarity, true means that you are offline.

isOffline.watch(fn)

Returns: Function

Returns a function that is used to disable/unmount the event listeners.

fn

Type: Function

The function to run whenever the network status changes. It receives a Boolean value, just like isOffline.

License

MIT © Luke Edwards