get-port-please

Get an available TCP port to listen

Usage

Install package:

yarn add get-port-please
# or
or npm install get-port-please

// ESM
import { getPort, checkPort, getRandomPort, waitForPort } from 'get-port-please'

// CommonJS
const { getPort, checkPort, getRandomPort, waitForPort } = require('get-port-please')

getPort(options?: GetPortOptions): Promise<number>
checkPort(port: number, host?: string): Promise<number | false>
waitForPort(port: number, options): Promise<number | false>

Try sequence is: port > ports > memo > random

Options

interface GetPortOptions {
  name?: string

  random?: boolean
  port?: number
  ports?: number[]
  host?: string

  memoDir?: string
  memoName?: string
}

name

Unique name for port memorizing. Default is default.

random

If enabled, port and ports will be ignored. Default is false.

port

First port to check. Default is process.env.PORT || 3000

ports

Alternative ports to check. Default is [4000, 5000, 6000, 7000]

host

The host to check. Default is process.env.HOST otherwise all available hosts will be checked.

memoDir / memoName

Options passed to fs-memo

• Default dir: node_modules/get-port/dist
• Defalt name: .get-port

License

MIT