aboutsummaryrefslogtreecommitdiff
path: root/node_modules/portfinder/README.md
diff options
context:
space:
mode:
authorruki <waruqi@gmail.com>2018-11-08 00:38:48 +0800
committerruki <waruqi@gmail.com>2018-11-07 21:53:09 +0800
commit26105034da4fcce7ac883c899d781f016559310d (patch)
treec459a5dc4e3aa0972d9919033ece511ce76dd129 /node_modules/portfinder/README.md
parent2c77f00f1a7ecb6c8192f9c16d3b2001b254a107 (diff)
downloadxmake-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.md73
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 [![Build Status](https://api.travis-ci.org/indexzero/node-portfinder.svg)](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