Sha256: a4222f8f29e9571cf038910facbe432c74d2fc5af9c8c897acbc6162cf6a67fd

Contents?: true

Size: 1.82 KB

Versions: 26

Compression:

Stored size: 1.82 KB

Contents

# default-gateway
[![](https://img.shields.io/npm/v/default-gateway.svg?style=flat)](https://www.npmjs.org/package/default-gateway) [![](https://img.shields.io/npm/dm/default-gateway.svg)](https://www.npmjs.org/package/default-gateway) [![](https://api.travis-ci.org/silverwind/default-gateway.svg?style=flat)](https://travis-ci.org/silverwind/default-gateway)

> Get the default network gateway, cross-platform.

Obtains the machine's default gateway through `exec` calls to OS routing interfaces. On Linux and Android, the `ip` command must be available (usually provided by the `iproute2` package). On IBM i, the `db2util` command must be available (provided by the `db2util` package).

## Installation

```
$ npm install default-gateway
```

## Example

```js
const defaultGateway = require('default-gateway');

defaultGateway.v4().then(result => {
  // result = {gateway: '1.2.3.4', interface: 'en1'}
});

defaultGateway.v6().then(result => {
  // result = {gateway: '2001:db8::1', interface: 'en2'}
});

const result = defaultGateway.v4.sync();
// result = {gateway: '1.2.3.4', interface: 'en1'}

const result = defaultGateway.v6.sync();
// result = {gateway: '2001:db8::1', interface: 'en2'}
```

## API
### defaultGateway.v4()
### defaultGateway.v6()
### defaultGateway.v4.sync()
### defaultGateway.v6.sync()

Returns: `result` *Object*
  - `gateway`: The IP address of the default gateway.
  - `interface`: The name of the interface. On Windows, this is the network adapter name.

The `.v{4,6}()` methods return a Promise while the `.v{4,6}.sync()` variants will return the result synchronously.

The `gateway` property will always be defined on success, while `interface` can be `null` if it cannot be determined. All methods reject/throw on unexpected conditions.

## License

© [silverwind](https://github.com/silverwind), distributed under BSD licence

Version data entries

26 entries across 25 versions & 8 rubygems

Version Path
optimacms-0.1.61 spec/dummy/node_modules/default-gateway/README.md
disco_app-0.18.0 test/dummy/node_modules/default-gateway/README.md
disco_app-0.18.2 test/dummy/node_modules/default-gateway/README.md
disco_app-0.16.1 test/dummy/node_modules/default-gateway/README.md
disco_app-0.15.2 test/dummy/node_modules/default-gateway/README.md
disco_app-0.18.4 test/dummy/node_modules/default-gateway/README.md
disco_app-0.18.1 test/dummy/node_modules/default-gateway/README.md
disco_app-0.12.7.pre.puma.pre.3 test/dummy/node_modules/default-gateway/README.md
disco_app-0.14.0 test/dummy/node_modules/default-gateway/README.md
disco_app-0.13.6.pre.puma.pre.3 test/dummy/node_modules/default-gateway/README.md
tang-0.2.1 spec/tang_app/node_modules/default-gateway/README.md
groonga-client-model-6.0.0 test/apps/rails6.0.3.5/node_modules/default-gateway/README.md
groonga-client-model-6.0.0 test/apps/rails6.1.3/node_modules/default-gateway/README.md
ruby2js-4.0.4 lib/tasks/testrails/node_modules/default-gateway/README.md
ruby2js-4.0.3 lib/tasks/testrails/node_modules/default-gateway/README.md
tang-0.2.0 spec/tang_app/node_modules/default-gateway/README.md
tang-0.1.0 spec/tang_app/node_modules/default-gateway/README.md
tang-0.0.9 spec/tang_app/node_modules/default-gateway/README.md
enju_library-0.3.8 spec/dummy/node_modules/default-gateway/README.md
jester-data-8.0.0 node_modules/default-gateway/README.md