You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

47 lines
1.8 KiB

4 years ago
  1. # requires-port
  2. [![Made by unshift](https://img.shields.io/badge/made%20by-unshift-00ffcc.svg?style=flat-square)](http://unshift.io)[![Version npm](http://img.shields.io/npm/v/requires-port.svg?style=flat-square)](http://browsenpm.org/package/requires-port)[![Build Status](http://img.shields.io/travis/unshiftio/requires-port/master.svg?style=flat-square)](https://travis-ci.org/unshiftio/requires-port)[![Dependencies](https://img.shields.io/david/unshiftio/requires-port.svg?style=flat-square)](https://david-dm.org/unshiftio/requires-port)[![Coverage Status](http://img.shields.io/coveralls/unshiftio/requires-port/master.svg?style=flat-square)](https://coveralls.io/r/unshiftio/requires-port?branch=master)[![IRC channel](http://img.shields.io/badge/IRC-irc.freenode.net%23unshift-00a8ff.svg?style=flat-square)](http://webchat.freenode.net/?channels=unshift)
  3. The module name says it all, check if a protocol requires a given port.
  4. ## Installation
  5. This module is intended to be used with browserify or Node.js and is distributed
  6. in the public npm registry. To install it simply run the following command from
  7. your CLI:
  8. ```j
  9. npm install --save requires-port
  10. ```
  11. ## Usage
  12. The module exports it self as function and requires 2 arguments:
  13. 1. The port number, can be a string or number.
  14. 2. Protocol, can be `http`, `http:` or even `https://yomoma.com`. We just split
  15. it at `:` and use the first result. We currently accept the following
  16. protocols:
  17. - `http`
  18. - `https`
  19. - `ws`
  20. - `wss`
  21. - `ftp`
  22. - `gopher`
  23. - `file`
  24. It returns a boolean that indicates if protocol requires this port to be added
  25. to your URL.
  26. ```js
  27. 'use strict';
  28. var required = require('requires-port');
  29. console.log(required('8080', 'http')) // true
  30. console.log(required('80', 'http')) // false
  31. ```
  32. # License
  33. MIT