71 lines
1.3 KiB
Markdown
71 lines
1.3 KiB
Markdown
# get-port-please
|
|
|
|
> Get an available TCP port to listen
|
|
|
|
[](https://npmjs.com/package/get-port-please)
|
|
[](https://npmjs.com/package/get-port-please)
|
|
|
|
## Usage
|
|
|
|
Install package:
|
|
|
|
```bash
|
|
yarn add get-port-please
|
|
# or
|
|
or npm install get-port-please
|
|
```
|
|
|
|
```js
|
|
const getPort = require('get-port-please')
|
|
// or
|
|
import getPort from 'get-port-please'
|
|
```
|
|
|
|
```ts
|
|
function getPort(options?: GetPortOptions): Promise<number>
|
|
```
|
|
|
|
Try sequence is: port > ports > memo > random
|
|
|
|
## Options
|
|
|
|
```ts
|
|
interface GetPortOptions {
|
|
name?: string
|
|
|
|
random?: boolean
|
|
port?: number
|
|
ports?: number[]
|
|
|
|
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]`
|
|
|
|
### `memoDir` / `memoName`
|
|
|
|
Options passed to [fs-memo](https://github.com/nuxt-contrib/fs-memo)
|
|
|
|
- Default dir: `node_modules/get-port/dist`
|
|
- Defalt name: `.get-port`
|
|
|
|
## License
|
|
|
|
MIT
|