lukeed

is-offline

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

See also

clsx(3), @polka/cluster(3), @pwa/cli(3), uvu(3), taskr(3), sockette(3), klona(3), kleur(3), dequal(3), sirv-cli(3)