port-status
Detect port availability.
Why?
- Fast and convenient, easy to set up.
- Namespaces builds in a human-friendly manner.
- Encourages cache-safe URLs.
- Uses a solid convention,
build/<branch>/<version>
. - Gracefully handles edge cases for git branches.
Install
npm install port-status --save
Usage
Get it into your program.
const portStatus = ;
Get a promise for the status of a port, as a lowercase string.
// On OS X without sudo, this will log 'Status: denied'.// If you use sudo and it is free, then 'Status: ok'.;
Port status passes all arguments to Node's net.Server#listen(), so you can also use an object, for example.
;
Make your .then() handler conditional, by using convenience methods that reject their promises if the port status is not exactly what you want.
// This will only log something if the port is already in use. Otherwise, the// promise will reject, and you could use .catch() to print something.
Contributing
See our contributing guidelines for more details.
- Fork it.
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request.
License
Go make something, dang it.