File Manager

Current Path: Root / node_modules/ default-gateway

Parent Directory

Name	Size	Last Modified
[F]LICENSE	1.26 KB	2022-10-08 17:28:23
[F]README.md Edit	1.77 KB	2022-10-08 17:28:24
[F]android.js Edit	940 bytes	2022-10-08 17:28:23
[F]darwin.js Edit	1.34 KB	2022-10-08 17:28:23
[F]freebsd.js Edit	1.01 KB	2022-10-08 17:28:24
[F]ibmi.js Edit	1.02 KB	2022-10-08 17:28:24
[F]index.js Edit	867 bytes	2022-10-08 17:28:24
[F]linux.js Edit	1.51 KB	2022-10-08 17:28:24
[F]openbsd.js Edit	1.08 KB	2022-10-08 17:28:24
[F]package.json Edit	781 bytes	2022-10-08 17:28:24
[F]sunos.js Edit	1.08 KB	2022-10-08 17:28:24
[F]win32.js Edit	3.10 KB	2022-10-08 17:28:24

Editing: README.md

# 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)

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 Windows, `wmic` must be available.
- On IBM i, the `db2util` command must be available (provided by the `db2util` package).
- On Unix (and macOS), the `netstat` command must be available.

## Installation

```
$ npm i default-gateway
```

## Example

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

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

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

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

const {gateway, interface} = defaultGateway.v6.sync();
// 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

Cancel

File Explorer

Navigation

File Manager

Editing: README.md

File Explorer

Navigation

File Manager

Editing: README.md

Confirm Deletion

Rename Item

Change Permissions (Chmod)