https://github.com/shystruk/no-internet
📡 Checking if the internet is accessible in the browser (not local connection only)
https://github.com/shystruk/no-internet
browser connectivity internet internet-connection javascript network offline online
Last synced: about 1 year ago
JSON representation
📡 Checking if the internet is accessible in the browser (not local connection only)
- Host: GitHub
- URL: https://github.com/shystruk/no-internet
- Owner: shystruk
- License: mit
- Created: 2017-12-15T09:37:46.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-07-11T13:14:50.000Z (almost 3 years ago)
- Last Synced: 2025-04-13T15:41:09.066Z (about 1 year ago)
- Topics: browser, connectivity, internet, internet-connection, javascript, network, offline, online
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/no-internet
- Size: 372 KB
- Stars: 36
- Watchers: 4
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# no-internet [](https://twitter.com/intent/tweet?hashtags=javascript%20%23Internet%20%23connection&original_referer=https%3A%2F%2Fpublish.twitter.com%2F&ref_src=twsrc%5Etfw&text=%F0%9F%93%A1Check%20if%20the%20internet%20is%20accessible%20(not%20local%20connection%20only).%20Do%20it%20in%20interval%20or%20one%20check%20&tw_p=tweetbutton&url=https%3A%2F%2Fgithub.com%2Fshystruk%2Fno-internet&via=shystrukk) #
[](https://opensource.org/licenses/mit-license.php) [](https://codecov.io/gh/shystruk/no-internet) [](https://travis-ci.org/shystruk/no-internet)
[](https://snyk.io/test/github/shystruk/no-internet?targetFile=package.json)
[](https://badge.fury.io/js/no-internet)
Checking if the internet is accessible in the browser (not local connection only)
`window.navigator.onLine` is the simplest approach to return the online status of the browser. It is not guaranteed to be accurate. Most implementations of the API watch for changes in the local network interface to determine if your application is online or not. But what if your network interface is up, but your router is down ☝️. `window.navigator.onLine` will return `true` and it means that you are online and that is WRONG. To handle that case we make `XMLHttpRequest` and listen to change in the network state by events `window.ononline` and `window.onoffline` to be notified immediately 😎
## Getting no-internet ##
#### npm
`npm install --save no-internet`
#### yarn
`yarn add no-internet --save`
## Examples ##
```javascript
import noInternet from 'no-internet'
```
### One check ###
```javascript
noInternet().then(offline => {
if (offline) {
// no internet
}
})
```
### Interval checking ###
```javascript
function noInternetCallback(offline) {
if (offline) {
// no internet
}
}
// connection is checked and callback is called each 5000 milliseconds
noInternet({ callback: noInternetCallback })
// clear interval
noInternet.clearInterval()
```
### With options ###
```javascript
noInternet({
milliseconds: 10000,
timeout: 4000,
callback: noInternetCallback,
url: 'https://github.com/favicon.ico',
headers: { 'Access-Control-Allow-Origin': '*' }
})
```
## API ##
### noInternet(options) ###
### options ###
Type: `Object`
#### milliseconds ####
Type: `number`
Default: 5000
Connection is checked at specified intervals (in milliseconds)
#### timeout ####
Type: `number`
Default: 5000
Number of milliseconds a request can take before automatically being terminated (completed).
#### url ####
Type: `string`
Default: `${window.location.protocol}//${window.location.host}/favicon.ico`
HTTP request is sent to `DOMAIN/favicon.ico` for connection checking.
You can specify URL with domain for e.g. `https://github.com/favicon.ico`
#### headers ####
Type: `Object`
Default: `{ 'Cache-Control': 'no-cache' }`
An object of additional headers key/value pairs to send along with request
#### callback ####
Type: `function`
Arguments: `offline` type `boolean`
Default: `undefined`
Function that gets called in each connection checking
## Contributing
Any contributions you make **are greatly appreciated**.
Please read the [Contributions Guidelines](CONTRIBUTING.md) before submitting a PR.
## License
MIT © [Vasyl Stokolosa](https://about.me/shystruk)