Necessitates Proper Modularity
Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

port-scout

1.1.2 • Public • Published

Port Scout

Port Scout is an easy way to get available ports with different needs.

NPM version Known Vulnerabilities NPM downloads issues license Gitter

Table of contents

Install

To install port-scout to use in your project locally, you can use:

$ npm install port-scout

If you plan on using port-scout as a CLI utility, you can install it globally to have access to the port-scout command anywhere:

$ npm install -g port-scout

Usage

Port Scout is exported as a series of functions so you can just require the port-scout module and use the method you desire to retrieve the port you want.

Note All port scouting methods are async and so will have to be wrapped in an async function call.

const scouter = require('port-scout');
 
async function main() {
  const webPort = await scouter.web();
}
 
main();

API

web

Checks common web ports to see what port is available and returns it.

Example:

async function main() {
  const webPort = await scouter.web();
}
 
main();

random

Tries random ports and returns the first available one. Ports 1-1024 are automatically avoided unless specified.

param type description default
allowRestricted boolean If set to true, this will allow ports 1-1024 to be tried. false

Example:

async function main() {
  const randomPort = await scouter.random();
}
 
main();

range

Checks a provided range of ports for the first available port and returns it.

param type description default
start number The start of the range of ports to check
end number The end of the range of ports to check 65535

Example:

async function main() {
  const rangePort = await scouter.range(3050, 3075);
}
 
main();

CLI Usage

Port can be used as a command line utility to retrieve an available port using one of its various methods and print it to the console like so:

$ port=scout -w

The customize the way ports are retrieved you can use a combination of the flags below:

-w, --web                : Returns a common web server port that can be used, these are normally in the low 3000s or 8080s.
-r, --random             : Returns a random port that can be used at the time of calling this.
-a, --range <start,end>  : Returns the first available port between a start and end value.
-f, --force              : This can be used in conjunction with the random or range flag to override the default rule of not allowing a port between 1 - 1024 to be tested.

Example:

For example, if you would like to get the first available port between 3050 and 3075 you can use:

$ port-scout -r 3050,3075

Install

npm i port-scout

DownloadsWeekly Downloads

8

Version

1.1.2

License

MIT

Unpacked Size

23.7 kB

Total Files

16

Last publish

Collaborators

  • avatar