diff options
| author | ruki <waruqi@gmail.com> | 2018-11-08 00:38:48 +0800 |
|---|---|---|
| committer | ruki <waruqi@gmail.com> | 2018-11-07 21:53:09 +0800 |
| commit | 26105034da4fcce7ac883c899d781f016559310d (patch) | |
| tree | c459a5dc4e3aa0972d9919033ece511ce76dd129 /node_modules/portfinder/README.md | |
| parent | 2c77f00f1a7ecb6c8192f9c16d3b2001b254a107 (diff) | |
| download | xmake-docs-26105034da4fcce7ac883c899d781f016559310d.tar.gz xmake-docs-26105034da4fcce7ac883c899d781f016559310d.zip | |
switch to vuepress
Diffstat (limited to 'node_modules/portfinder/README.md')
| -rw-r--r-- | node_modules/portfinder/README.md | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/node_modules/portfinder/README.md b/node_modules/portfinder/README.md new file mode 100644 index 00000000..5d3d8f36 --- /dev/null +++ b/node_modules/portfinder/README.md @@ -0,0 +1,73 @@ +# node-portfinder [](https://travis-ci.org/indexzero/node-portfinder) + +## Installation + +``` bash + $ [sudo] npm install portfinder +``` + +## Usage +The `portfinder` module has a simple interface: + +``` js + var portfinder = require('portfinder'); + + portfinder.getPort(function (err, port) { + // + // `port` is guaranteed to be a free port + // in this scope. + // + }); +``` + +Or with promise (if Promise are supported) : + +``` js + const portfinder = require('portfinder'); + + portfinder.getPortPromise() + .then((port) => { + // + // `port` is guaranteed to be a free port + // in this scope. + // + }) + .catch((err) => { + // + // Could not get a free port, `err` contains the reason. + // + }); +``` + +If `portfinder.getPortPromise()` is called on a Node version without Promise (<4), it will throw an Error unless [Bluebird](http://bluebirdjs.com/docs/getting-started.html) or any Promise pollyfill is used. + +### Ports search scope + +By default `portfinder` will start searching from `8000` and scan until maximum port number (`65535`) is reached. + +You can change this globally by setting: + +```js +portfinder.basePort = 3000; // default: 8000 +portfinder.highestPort = 3333; // default: 65535 +``` + +or by passing optional options object on each invocation: + +```js +portfinder.getPort({ + port: 3000, // minimum port + stopPort: 3333 // maximum port +}, callback); +``` + +## Run Tests +``` bash + $ npm test +``` + +#### Author: [Charlie Robbins][0] +#### Maintainer: [Erik Trom][1] +#### License: MIT/X11 +[0]: http://nodejitsu.com +[1]: https://github.com/eriktrom |
