Socket
Socket
Sign inDemoInstall

freeport-async

Package Overview
Dependencies
Maintainers
18
Versions
4
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

freeport-async

Finds an available port for your application to use.


Version published
Weekly downloads
625K
decreased by-0.42%
Maintainers
18
Weekly downloads
 
Created
Source

freeport-async

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.

Usage

Basic

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

let portICanUse = await freeportAsync();

Advanced

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 https://gist.github.com/mikeal/1840641

Keywords

FAQs

Package last updated on 11 Oct 2019

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc