cat-bookmarker/assets/node_modules/default-gateway
Nat 96939b7aee
Clean up repo and update deps
2024-03-10 11:52:04 -07:00
..
LICENSE Clean up repo and update deps 2024-03-10 11:52:04 -07:00
README.md Clean up repo and update deps 2024-03-10 11:52:04 -07:00
android.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00
darwin.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00
freebsd.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00
ibmi.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00
index.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00
linux.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00
openbsd.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00
package.json Clean up repo and update deps 2024-03-10 11:52:04 -07:00
sunos.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00
win32.js Clean up repo and update deps 2024-03-10 11:52:04 -07:00

README.md

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

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

© silverwind, distributed under BSD licence