Finds an available port for your application to use.
Last updated a year ago by fson .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install freeport-async 
SYNC missed versions from official npm registry.


Finds an available port for your application to use. You can specify a range where to look for an available port. And can also find a range of available ports for you to use. You can also be used to test to see if a given port is available.

All functions are async and return Promises.



let freeportAsync = require("freeport-async");

let portICanUse = await freeportAsync();


let freeportAsync = require("freeport-async");

let portIn9000Range = await freeportAsync(9000);

let portAvailableForAnyOrLocalhost = await freeportAsync(9000, {
  hostnames: [null, "localhost"]

let isPort5000Available = await freeportAsync.availableAsync(5000);

let listOf5ConsecutiveAvailablePorts = await freeportAsync.rangeAsync(5);

let freeRangeIn12000Range = await freeportAsync.rangeAsync(3, 12000);

Important Note

Note that this code just finds available ports, but doesn't reserve them in any way. This means that if you have other code that might be looking for a port in the same range at the same time, you could run into issues.

Also, if you call freeportAsync twice in a row, it will often return the same port number twice. If you want to find two (or more) ports you can use, you need to call freeportAsync.rangeAsync(<number-of-ports>, [startSearchFrom]).

See also

Current Tags

  • 2.0.0                                ...           latest (a year ago)

4 Versions

  • 2.0.0                                ...           a year ago
  • 1.1.1                                ...           4 years ago
  • 1.1.0                                ...           6 years ago
  • 1.0.0                                ...           6 years ago

Copyright 2014 - 2016 © |