Skip to content

A Node.js Module to check whether you are connected to network or not.

License

Notifications You must be signed in to change notification settings

Syed-Umair/check-network-status

Repository files navigation

Build GitHub license Twitter

check-network-status

A Node.js Module to check whether you are connected to network or not. Returns a promise resolves to true with network access and to false without network access.

Install Module

    npm install check-network-status

Note: Requires Node >= 8.0.0

Usage

With Default Options

{
    timeout: 4500,
    backUpURL: null,
    pingDomain: 'google.com',
    method: 'GET'
}
    const { checkNetworkStatus } = require('check-network-status');
    checkNetworkStatus().then(value => console.log(value));
    // prints 'true' or 'false' depending on networking connectivity

With Options

  • timeout: milliseconds
  • url: string with protocol
    const { checkNetworkStatus } = require('check-network-status');
    checkNetworkStatus({
        timeout: 3000,
        backUpURL: 'https://example.com',
        pingDomain: 'github.com',
        method: 'GET'
    }).then(value => console.log(value));
    // prints 'true' or 'false' depending on networking connectivity

ChangeLog

v1.2.0 -> v1.2.3 includes following changes

  • fixes unhandled timeout error
  • stopped printing debug logs

v1.1.3 -> v1.2.0 breaking changes include

Renamed option url to backUpURL

Added option method that accepts HTTP methods to be used while requesting backUpURL. It defaults to GET.

We updated the network check API to cloudflare DNS query API, you need to pass the pingDomain option if you don't want to use default value google.com

About

A Node.js Module to check whether you are connected to network or not.

Topics

Resources

License

Stars

Watchers

Forks

Packages