Installations

npm install detect-port-alt

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Min. Node Version

>= 4.2.1

Node Version

8.9.1

NPM Version

5.7.1 Score

98.8

Supply Chain

100

Quality

77.3

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

42

Closed

5

Merged

37

Issues

Open

1

Total

18

Closed

17

Releases

14

v2.1.0

Updated on Dec 10, 2024

v2.0.1

Updated on Dec 08, 2024

v2.0.0

Updated on Dec 08, 2024

v1.6.1

Updated on May 08, 2024

v1.6.0

Updated on May 08, 2024

v1.5.1

Updated on May 08, 2024

View All 14 releases

Languages

2

TypeScript

JavaScript

TypeScript (86.2%)

JavaScript (13.8%)

Developer

node-modules

Download Statistics

Total Downloads

1,409,281,674

Last Day

279,879

Last Week

4,387,670

Last Month

19,141,353

Last Year

215,347,430

GitHub Statistics

MIT License

389 Stars

90 Commits

25 Forks

14 Watchers

2 Branches

28 Contributors

Updated on May 26, 2025

Bundle Size

7.41 kB

Minified

3.14 kB

Minified + Gzipped

Bundlephobia

Maintainers

1

View All 28 Contributors

Package Meta Information

Latest Version

1.1.6

Package Id

detect-port-alt@1.1.6

Size

25.87 kB

NPM Version

5.7.1

Node Version

8.9.1

Published on

Apr 03, 2018

Total Downloads

Cumulative downloads

Total Downloads

1,409,281,674

Last Day

-16.4%

279,879

Compared to previous day

Last Week

-12.1%

4,387,670

Compared to previous week

Last Month

5.2%

19,141,353

Compared to previous month

Last Year

-5.2%

215,347,430

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

2

address debug

Dev Dependencies

6

command-line-test egg-bin egg-ci eslint eslint-config-egg pedding

JavaScript Implementation of Port Detector

Usage

1$ npm i detect-port --save

1const detect = require('detect-port');
2
3/**
4 * callback usage
5 */
6
7detect(port, (err, _port) => {
8  if (err) {
9    console.log(err);
10  }
11
12  if (port == _port) {
13    console.log(`port: ${port} was not occupied`);
14  } else {
15    console.log(`port: ${port} was occupied, try port: ${_port}`);
16  }
17});
18
19/**
20 * for a yield syntax instead of callback function implement
21 */
22
23const co = require('co');
24
25co(function *() {
26  const _port = yield detect(port);
27
28  if (port == _port) {
29    console.log(`port: ${port} was not occupied`);
30  } else {
31    console.log(`port: ${port} was occupied, try port: ${_port}`);
32  }
33});
34
35/**
36 * use as a promise
37 */
38
39detect(port)
40  .then(_port => {
41    if (port == _port) {
42      console.log(`port: ${port} was not occupied`);
43    } else {
44      console.log(`port: ${port} was occupied, try port: ${_port}`);
45    }
46  })
47  .catch(err => {
48    console.log(err);
49  });
50

Command Line Tool

1$ npm i detect-port -g

Quick Start

1# get an available port randomly
2$ detect
3
4# detect pointed port
5$ detect 80
6
7# more help
8$ detect --help

Authors

License

MIT

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

2

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

0

SAST

Determines if the project uses static code analysis.

Score

4

/10

Last Scanned on 2025-06-30

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More