get-port

  • Version 7.0.0
  • Published
  • 10.7 kB
  • No dependencies
  • MIT license

Install

npm i get-port
yarn add get-port
pnpm add get-port

Overview

Get an available port

Index

Functions

Type Aliases

Functions

function getPort

getPort: (options?: Options) => Promise<number>;
  • Get an available TCP port number.

    Returns

    Port number.

    Example 1

    import getPort from 'get-port';
    console.log(await getPort());
    //=> 51402
    // Pass in a preferred port
    console.log(await getPort({port: 3000}));
    // Will use 3000 if available, otherwise fall back to a random port
    // Pass in an array of preferred ports
    console.log(await getPort({port: [3000, 3001, 3002]}));
    // Will use any element in the preferred ports array if available, otherwise fall back to a random port

function portNumbers

portNumbers: (from: number, to: number) => Iterable<number>;
  • Generate port numbers in the given range from...to.

    Parameter from

    The first port of the range. Must be in the range 1024...65535.

    Parameter to

    The last port of the range. Must be in the range 1024...65535 and must be greater than from.

    Returns

    The port numbers in the range.

    Example 1

    import getPort, {portNumbers} from 'get-port';
    console.log(await getPort({port: portNumbers(3000, 3100)}));
    // Will use any port from 3000 to 3100, otherwise fall back to a random port

Type Aliases

type Options

type Options = {
/**
A preferred port or an iterable of preferred ports to use.
*/
readonly port?: number | Iterable<number>;
/**
Ports that should not be returned.
You could, for example, pass it the return value of the `portNumbers()` function.
*/
readonly exclude?: Iterable<number>;
/**
The host on which port resolution should be performed. Can be either an IPv4 or IPv6 address.
By default, it checks availability on all local addresses defined in [OS network interfaces](https://nodejs.org/api/os.html#os_os_networkinterfaces). If this option is set, it will only check the given host.
*/
readonly host?: string;
} & Omit<ListenOptions, 'port'>;

    Package Files (1)

    Dependencies (0)

    No dependencies.

    Dev Dependencies (4)

    Peer Dependencies (0)

    No peer dependencies.

    Badge

    To add a badge like this onejsDocs.io badgeto your package's README, use the codes available below.

    You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/get-port.

    • Markdown
      [![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue)](https://www.jsdocs.io/package/get-port)
    • HTML
      <a href="https://www.jsdocs.io/package/get-port"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>