údržba
This commit is contained in:
		
							
								
								
									
										3
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/.jscsrc
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										3
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/.jscsrc
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,3 @@
 | 
			
		||||
{
 | 
			
		||||
  "preset": "node-style-guide"
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										15
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/.jshintrc
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										15
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/.jshintrc
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,15 @@
 | 
			
		||||
{
 | 
			
		||||
  "curly": true,
 | 
			
		||||
  "eqeqeq": true,
 | 
			
		||||
  "freeze": true,
 | 
			
		||||
  "indent": 2,
 | 
			
		||||
  "newcap": true,
 | 
			
		||||
  "quotmark": "single",
 | 
			
		||||
  "maxdepth": 3,
 | 
			
		||||
  "maxlen": 80,
 | 
			
		||||
  "eqnull": true,
 | 
			
		||||
  "funcscope": true,
 | 
			
		||||
  "node": true,
 | 
			
		||||
  "undef": true,
 | 
			
		||||
  "unused": "vars"
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										3
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/.npmignore
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										3
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/.npmignore
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,3 @@
 | 
			
		||||
*.swp
 | 
			
		||||
coverage/
 | 
			
		||||
node_modules/
 | 
			
		||||
							
								
								
									
										10
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/.travis.yml
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										10
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/.travis.yml
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,10 @@
 | 
			
		||||
language: node_js
 | 
			
		||||
node_js:
 | 
			
		||||
  - node
 | 
			
		||||
  - 0.10
 | 
			
		||||
script:
 | 
			
		||||
  - npm run lint
 | 
			
		||||
  # test-coverage will also run the tests, but does not print helpful output upon test failure.
 | 
			
		||||
  # So we also run the tests separately.
 | 
			
		||||
  - npm run test
 | 
			
		||||
  - npm run test-coverage && cat coverage/lcov.info | ./node_modules/.bin/coveralls && rm -rf coverage
 | 
			
		||||
							
								
								
									
										131
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/README.md
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										131
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/README.md
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,131 @@
 | 
			
		||||
# proxy-from-env
 | 
			
		||||
 | 
			
		||||
[](https://travis-ci.org/Rob--W/proxy-from-env)
 | 
			
		||||
[](https://coveralls.io/github/Rob--W/proxy-from-env?branch=master)
 | 
			
		||||
 | 
			
		||||
`proxy-from-env` is a Node.js package that exports a function (`getProxyForUrl`)
 | 
			
		||||
that takes an input URL (a string or
 | 
			
		||||
[`url.parse`](https://nodejs.org/docs/latest/api/url.html#url_url_parsing)'s
 | 
			
		||||
return value) and returns the desired proxy URL (also a string) based on
 | 
			
		||||
standard proxy environment variables. If no proxy is set, an empty string is
 | 
			
		||||
returned.
 | 
			
		||||
 | 
			
		||||
It is your responsibility to actually proxy the request using the given URL.
 | 
			
		||||
 | 
			
		||||
Installation:
 | 
			
		||||
 | 
			
		||||
```sh
 | 
			
		||||
npm install proxy-from-env
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Example
 | 
			
		||||
This example shows how the data for a URL can be fetched via the
 | 
			
		||||
[`http` module](https://nodejs.org/api/http.html), in a proxy-aware way.
 | 
			
		||||
 | 
			
		||||
```javascript
 | 
			
		||||
var http = require('http');
 | 
			
		||||
var parseUrl = require('url').parse;
 | 
			
		||||
var getProxyForUrl = require('proxy-from-env').getProxyForUrl;
 | 
			
		||||
 | 
			
		||||
var some_url = 'http://example.com/something';
 | 
			
		||||
 | 
			
		||||
// // Example, if there is a proxy server at 10.0.0.1:1234, then setting the
 | 
			
		||||
// // http_proxy environment variable causes the request to go through a proxy.
 | 
			
		||||
// process.env.http_proxy = 'http://10.0.0.1:1234';
 | 
			
		||||
// 
 | 
			
		||||
// // But if the host to be proxied is listed in NO_PROXY, then the request is
 | 
			
		||||
// // not proxied (but a direct request is made).
 | 
			
		||||
// process.env.no_proxy = 'example.com';
 | 
			
		||||
 | 
			
		||||
var proxy_url = getProxyForUrl(some_url);  // <-- Our magic.
 | 
			
		||||
if (proxy_url) {
 | 
			
		||||
  // Should be proxied through proxy_url.
 | 
			
		||||
  var parsed_some_url = parseUrl(some_url);
 | 
			
		||||
  var parsed_proxy_url = parseUrl(proxy_url);
 | 
			
		||||
  // A HTTP proxy is quite simple. It is similar to a normal request, except the
 | 
			
		||||
  // path is an absolute URL, and the proxied URL's host is put in the header
 | 
			
		||||
  // instead of the server's actual host.
 | 
			
		||||
  httpOptions = {
 | 
			
		||||
    protocol: parsed_proxy_url.protocol,
 | 
			
		||||
    hostname: parsed_proxy_url.hostname,
 | 
			
		||||
    port: parsed_proxy_url.port,
 | 
			
		||||
    path: parsed_some_url.href,
 | 
			
		||||
    headers: {
 | 
			
		||||
      Host: parsed_some_url.host,  // = host name + optional port.
 | 
			
		||||
    },
 | 
			
		||||
  };
 | 
			
		||||
} else {
 | 
			
		||||
  // Direct request.
 | 
			
		||||
  httpOptions = some_url;
 | 
			
		||||
}
 | 
			
		||||
http.get(httpOptions, function(res) {
 | 
			
		||||
  var responses = [];
 | 
			
		||||
  res.on('data', function(chunk) { responses.push(chunk); });
 | 
			
		||||
  res.on('end', function() { console.log(responses.join(''));  });
 | 
			
		||||
});
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Environment variables
 | 
			
		||||
The environment variables can be specified in lowercase or uppercase, with the
 | 
			
		||||
lowercase name having precedence over the uppercase variant. A variable that is
 | 
			
		||||
not set has the same meaning as a variable that is set but has no value.
 | 
			
		||||
 | 
			
		||||
### NO\_PROXY
 | 
			
		||||
 | 
			
		||||
`NO_PROXY` is a list of host names (optionally with a port). If the input URL
 | 
			
		||||
matches any of the entries in `NO_PROXY`, then the input URL should be fetched
 | 
			
		||||
by a direct request (i.e. without a proxy).
 | 
			
		||||
 | 
			
		||||
Matching follows the following rules:
 | 
			
		||||
 | 
			
		||||
- `NO_PROXY=*` disables all proxies.
 | 
			
		||||
- Space and commas may be used to separate the entries in the `NO_PROXY` list.
 | 
			
		||||
- If `NO_PROXY` does not contain any entries, then proxies are never disabled.
 | 
			
		||||
- If a port is added after the host name, then the ports must match. If the URL
 | 
			
		||||
  does not have an explicit port name, the protocol's default port is used.
 | 
			
		||||
- Generally, the proxy is only disabled if the host name is an exact match for
 | 
			
		||||
  an entry in the `NO_PROXY` list. The only exceptions are entries that start
 | 
			
		||||
  with a dot or with a wildcard; then the proxy is disabled if the host name
 | 
			
		||||
  ends with the entry.
 | 
			
		||||
 | 
			
		||||
See `test.js` for examples of what should match and what does not.
 | 
			
		||||
 | 
			
		||||
### \*\_PROXY
 | 
			
		||||
 | 
			
		||||
The environment variable used for the proxy depends on the protocol of the URL.
 | 
			
		||||
For example, `https://example.com` uses the "https" protocol, and therefore the
 | 
			
		||||
proxy to be used is `HTTPS_PROXY` (_NOT_ `HTTP_PROXY`, which is _only_ used for
 | 
			
		||||
http:-URLs).
 | 
			
		||||
 | 
			
		||||
The library is not limited to http(s), other schemes such as
 | 
			
		||||
`FTP_PROXY` (ftp:),
 | 
			
		||||
`WSS_PROXY` (wss:),
 | 
			
		||||
`WS_PROXY` (ws:)
 | 
			
		||||
are also supported.
 | 
			
		||||
 | 
			
		||||
If present, `ALL_PROXY` is used as fallback if there is no other match.
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## External resources
 | 
			
		||||
The exact way of parsing the environment variables is not codified in any
 | 
			
		||||
standard. This library is designed to be compatible with formats as expected by
 | 
			
		||||
existing software.
 | 
			
		||||
The following resources were used to determine the desired behavior:
 | 
			
		||||
 | 
			
		||||
- cURL:
 | 
			
		||||
  https://curl.haxx.se/docs/manpage.html#ENVIRONMENT  
 | 
			
		||||
  https://github.com/curl/curl/blob/4af40b3646d3b09f68e419f7ca866ff395d1f897/lib/url.c#L4446-L4514  
 | 
			
		||||
  https://github.com/curl/curl/blob/4af40b3646d3b09f68e419f7ca866ff395d1f897/lib/url.c#L4608-L4638  
 | 
			
		||||
 | 
			
		||||
- wget: 
 | 
			
		||||
  https://www.gnu.org/software/wget/manual/wget.html#Proxies  
 | 
			
		||||
  http://git.savannah.gnu.org/cgit/wget.git/tree/src/init.c?id=636a5f9a1c508aa39e35a3a8e9e54520a284d93d#n383  
 | 
			
		||||
  http://git.savannah.gnu.org/cgit/wget.git/tree/src/retr.c?id=93c1517c4071c4288ba5a4b038e7634e4c6b5482#n1278  
 | 
			
		||||
 | 
			
		||||
- W3:
 | 
			
		||||
  https://www.w3.org/Daemon/User/Proxies/ProxyClients.html  
 | 
			
		||||
 | 
			
		||||
- Python's urllib:
 | 
			
		||||
  https://github.com/python/cpython/blob/936135bb97fe04223aa30ca6e98eac8f3ed6b349/Lib/urllib/request.py#L755-L782  
 | 
			
		||||
  https://github.com/python/cpython/blob/936135bb97fe04223aa30ca6e98eac8f3ed6b349/Lib/urllib/request.py#L2444-L2479
 | 
			
		||||
							
								
								
									
										103
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/index.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										103
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/index.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,103 @@
 | 
			
		||||
'use strict';
 | 
			
		||||
 | 
			
		||||
var parseUrl = require('url').parse;
 | 
			
		||||
 | 
			
		||||
var DEFAULT_PORTS = {
 | 
			
		||||
  ftp: 21,
 | 
			
		||||
  gopher: 70,
 | 
			
		||||
  http: 80,
 | 
			
		||||
  https: 443,
 | 
			
		||||
  ws: 80,
 | 
			
		||||
  wss: 443,
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
var stringEndsWith = String.prototype.endsWith || function(s) {
 | 
			
		||||
  return s.length <= this.length &&
 | 
			
		||||
    this.indexOf(s, this.length - s.length) !== -1;
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * @param {string|object} url - The URL, or the result from url.parse.
 | 
			
		||||
 * @return {string} The URL of the proxy that should handle the request to the
 | 
			
		||||
 *  given URL. If no proxy is set, this will be an empty string.
 | 
			
		||||
 */
 | 
			
		||||
function getProxyForUrl(url) {
 | 
			
		||||
  var parsedUrl = typeof url === 'string' ? parseUrl(url) : url || {};
 | 
			
		||||
  var proto = parsedUrl.protocol;
 | 
			
		||||
  var hostname = parsedUrl.host;
 | 
			
		||||
  var port = parsedUrl.port;
 | 
			
		||||
  if (typeof hostname !== 'string' || !hostname || typeof proto !== 'string') {
 | 
			
		||||
    return '';  // Don't proxy URLs without a valid scheme or host.
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  proto = proto.split(':', 1)[0];
 | 
			
		||||
  // Stripping ports in this way instead of using parsedUrl.hostname to make
 | 
			
		||||
  // sure that the brackets around IPv6 addresses are kept.
 | 
			
		||||
  hostname = hostname.replace(/:\d*$/, '');
 | 
			
		||||
  port = parseInt(port) || DEFAULT_PORTS[proto] || 0;
 | 
			
		||||
  if (!shouldProxy(hostname, port)) {
 | 
			
		||||
    return '';  // Don't proxy URLs that match NO_PROXY.
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  var proxy = getEnv(proto + '_proxy') || getEnv('all_proxy');
 | 
			
		||||
  if (proxy && proxy.indexOf('://') === -1) {
 | 
			
		||||
    // Missing scheme in proxy, default to the requested URL's scheme.
 | 
			
		||||
    proxy = proto + '://' + proxy;
 | 
			
		||||
  }
 | 
			
		||||
  return proxy;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Determines whether a given URL should be proxied.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {string} hostname - The host name of the URL.
 | 
			
		||||
 * @param {number} port - The effective port of the URL.
 | 
			
		||||
 * @returns {boolean} Whether the given URL should be proxied.
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
function shouldProxy(hostname, port) {
 | 
			
		||||
  var NO_PROXY = getEnv('no_proxy').toLowerCase();
 | 
			
		||||
  if (!NO_PROXY) {
 | 
			
		||||
    return true;  // Always proxy if NO_PROXY is not set.
 | 
			
		||||
  }
 | 
			
		||||
  if (NO_PROXY === '*') {
 | 
			
		||||
    return false;  // Never proxy if wildcard is set.
 | 
			
		||||
  }
 | 
			
		||||
 | 
			
		||||
  return NO_PROXY.split(/[,\s]/).every(function(proxy) {
 | 
			
		||||
    if (!proxy) {
 | 
			
		||||
      return true;  // Skip zero-length hosts.
 | 
			
		||||
    }
 | 
			
		||||
    var parsedProxy = proxy.match(/^(.+):(\d+)$/);
 | 
			
		||||
    var parsedProxyHostname = parsedProxy ? parsedProxy[1] : proxy;
 | 
			
		||||
    var parsedProxyPort = parsedProxy ? parseInt(parsedProxy[2]) : 0;
 | 
			
		||||
    if (parsedProxyPort && parsedProxyPort !== port) {
 | 
			
		||||
      return true;  // Skip if ports don't match.
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    if (!/^[.*]/.test(parsedProxyHostname)) {
 | 
			
		||||
      // No wildcards, so stop proxying if there is an exact match.
 | 
			
		||||
      return hostname !== parsedProxyHostname;
 | 
			
		||||
    }
 | 
			
		||||
 | 
			
		||||
    if (parsedProxyHostname.charAt(0) === '*') {
 | 
			
		||||
      // Remove leading wildcard.
 | 
			
		||||
      parsedProxyHostname = parsedProxyHostname.slice(1);
 | 
			
		||||
    }
 | 
			
		||||
    // Stop proxying if the hostname ends with the no_proxy host.
 | 
			
		||||
    return !stringEndsWith.call(hostname, parsedProxyHostname);
 | 
			
		||||
  });
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * Get the value for an environment variable.
 | 
			
		||||
 *
 | 
			
		||||
 * @param {string} key - The name of the environment variable.
 | 
			
		||||
 * @return {string} The value of the environment variable.
 | 
			
		||||
 * @private
 | 
			
		||||
 */
 | 
			
		||||
function getEnv(key) {
 | 
			
		||||
  return process.env[key.toLowerCase()] || process.env[key.toUpperCase()] || '';
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
exports.getProxyForUrl = getProxyForUrl;
 | 
			
		||||
							
								
								
									
										35
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/package.json
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										35
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/package.json
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,35 @@
 | 
			
		||||
{
 | 
			
		||||
  "name": "proxy-from-env",
 | 
			
		||||
  "version": "1.0.0",
 | 
			
		||||
  "description": "Offers getProxyForUrl to get the proxy URL for a URL, respecting the *_PROXY (e.g. HTTP_PROXY) and NO_PROXY environment variables.",
 | 
			
		||||
  "main": "index.js",
 | 
			
		||||
  "scripts": {
 | 
			
		||||
    "lint": "jscs *.js && jshint *.js",
 | 
			
		||||
    "test": "mocha ./test.js --reporter spec",
 | 
			
		||||
    "test-coverage": "istanbul cover ./node_modules/.bin/_mocha -- --reporter spec"
 | 
			
		||||
  },
 | 
			
		||||
  "repository": {
 | 
			
		||||
    "type": "git",
 | 
			
		||||
    "url": "https://github.com/Rob--W/proxy-from-env.git"
 | 
			
		||||
  },
 | 
			
		||||
  "keywords": [
 | 
			
		||||
    "proxy",
 | 
			
		||||
    "http_proxy",
 | 
			
		||||
    "https_proxy",
 | 
			
		||||
    "no_proxy",
 | 
			
		||||
    "environment"
 | 
			
		||||
  ],
 | 
			
		||||
  "author": "Rob Wu <rob@robwu.nl> (https://robwu.nl/)",
 | 
			
		||||
  "license": "MIT",
 | 
			
		||||
  "bugs": {
 | 
			
		||||
    "url": "https://github.com/Rob--W/proxy-from-env/issues"
 | 
			
		||||
  },
 | 
			
		||||
  "homepage": "https://github.com/Rob--W/proxy-from-env#readme",
 | 
			
		||||
  "devDependencies": {
 | 
			
		||||
    "coveralls": "^2.11.6",
 | 
			
		||||
    "istanbul": "^0.4.2",
 | 
			
		||||
    "jscs": "^2.10.1",
 | 
			
		||||
    "jshint": "^2.9.1",
 | 
			
		||||
    "mocha": "^2.4.5"
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
							
								
								
									
										393
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/test.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							
							
						
						
									
										393
									
								
								CyLukTs/lukan/node_modules/proxy-from-env/test.js
									
									
									
										generated
									
									
										vendored
									
									
										Normal file
									
								
							@@ -0,0 +1,393 @@
 | 
			
		||||
/* jshint mocha:true */
 | 
			
		||||
'use strict';
 | 
			
		||||
 | 
			
		||||
var assert = require('assert');
 | 
			
		||||
var parseUrl = require('url').parse;
 | 
			
		||||
 | 
			
		||||
var getProxyForUrl = require('./').getProxyForUrl;
 | 
			
		||||
 | 
			
		||||
// Runs the callback with process.env temporarily set to env.
 | 
			
		||||
function runWithEnv(env, callback) {
 | 
			
		||||
  var originalEnv = process.env;
 | 
			
		||||
  process.env = env;
 | 
			
		||||
  try {
 | 
			
		||||
    callback();
 | 
			
		||||
  } finally {
 | 
			
		||||
    process.env = originalEnv;
 | 
			
		||||
  }
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
// Defines a test case that checks whether getProxyForUrl(input) === expected.
 | 
			
		||||
function testProxyUrl(env, expected, input) {
 | 
			
		||||
  assert(typeof env === 'object' && env !== null);
 | 
			
		||||
  // Copy object to make sure that the in param does not get modified between
 | 
			
		||||
  // the call of this function and the use of it below.
 | 
			
		||||
  env = JSON.parse(JSON.stringify(env));
 | 
			
		||||
 | 
			
		||||
  var title = 'getProxyForUrl(' + JSON.stringify(input) + ')' +
 | 
			
		||||
     ' === ' + JSON.stringify(expected);
 | 
			
		||||
 | 
			
		||||
  // Save call stack for later use.
 | 
			
		||||
  var stack = {};
 | 
			
		||||
  Error.captureStackTrace(stack, testProxyUrl);
 | 
			
		||||
  // Only use the last stack frame because that shows where this function is
 | 
			
		||||
  // called, and that is sufficient for our purpose. No need to flood the logs
 | 
			
		||||
  // with an uninteresting stack trace.
 | 
			
		||||
  stack = stack.stack.split('\n', 2)[1];
 | 
			
		||||
 | 
			
		||||
  it(title, function() {
 | 
			
		||||
    var actual;
 | 
			
		||||
    runWithEnv(env, function() {
 | 
			
		||||
      actual = getProxyForUrl(input);
 | 
			
		||||
    });
 | 
			
		||||
    if (expected === actual) {
 | 
			
		||||
      return;  // Good!
 | 
			
		||||
    }
 | 
			
		||||
    try {
 | 
			
		||||
      assert.strictEqual(expected, actual); // Create a formatted error message.
 | 
			
		||||
      // Should not happen because previously we determined expected !== actual.
 | 
			
		||||
      throw new Error('assert.strictEqual passed. This is impossible!');
 | 
			
		||||
    } catch (e) {
 | 
			
		||||
      // Use the original stack trace, so we can see a helpful line number.
 | 
			
		||||
      e.stack = e.message + stack;
 | 
			
		||||
      throw e;
 | 
			
		||||
    }
 | 
			
		||||
  });
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
describe('getProxyForUrl', function() {
 | 
			
		||||
  describe('No proxy variables', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    testProxyUrl(env, '', 'http://example.com');
 | 
			
		||||
    testProxyUrl(env, '', 'https://example.com');
 | 
			
		||||
    testProxyUrl(env, '', 'ftp://example.com');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('Invalid URLs', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.ALL_PROXY = 'http://unexpected.proxy';
 | 
			
		||||
    testProxyUrl(env, '', 'bogus');
 | 
			
		||||
    testProxyUrl(env, '', '//example.com');
 | 
			
		||||
    testProxyUrl(env, '', '://example.com');
 | 
			
		||||
    testProxyUrl(env, '', '://');
 | 
			
		||||
    testProxyUrl(env, '', '/path');
 | 
			
		||||
    testProxyUrl(env, '', '');
 | 
			
		||||
    testProxyUrl(env, '', 'http:');
 | 
			
		||||
    testProxyUrl(env, '', 'http:/');
 | 
			
		||||
    testProxyUrl(env, '', 'http://');
 | 
			
		||||
    testProxyUrl(env, '', 'prototype://');
 | 
			
		||||
    testProxyUrl(env, '', 'hasOwnProperty://');
 | 
			
		||||
    testProxyUrl(env, '', '__proto__://');
 | 
			
		||||
    testProxyUrl(env, '', undefined);
 | 
			
		||||
    testProxyUrl(env, '', null);
 | 
			
		||||
    testProxyUrl(env, '', {});
 | 
			
		||||
    testProxyUrl(env, '', {host: 'x', protocol: 1});
 | 
			
		||||
    testProxyUrl(env, '', {host: 1, protocol: 'x'});
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('http_proxy and HTTP_PROXY', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://http-proxy';
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'https://example');
 | 
			
		||||
    testProxyUrl(env, 'http://http-proxy', 'http://example');
 | 
			
		||||
    testProxyUrl(env, 'http://http-proxy', parseUrl('http://example'));
 | 
			
		||||
 | 
			
		||||
    // jscs:disable requireCamelCaseOrUpperCaseIdentifiers
 | 
			
		||||
    env.http_proxy = 'http://priority';
 | 
			
		||||
    // jscs:enable requireCamelCaseOrUpperCaseIdentifiers
 | 
			
		||||
    testProxyUrl(env, 'http://priority', 'http://example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('http_proxy with non-sensical value', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    // Crazy values should be passed as-is. It is the responsibility of the
 | 
			
		||||
    // one who launches the application that the value makes sense.
 | 
			
		||||
    // TODO: Should we be stricter and perform validation?
 | 
			
		||||
    env.HTTP_PROXY = 'Crazy \n!() { ::// }';
 | 
			
		||||
    testProxyUrl(env, 'Crazy \n!() { ::// }', 'http://wow');
 | 
			
		||||
 | 
			
		||||
    // The implementation assumes that the HTTP_PROXY environment variable is
 | 
			
		||||
    // somewhat reasonable, and if the scheme is missing, it is added.
 | 
			
		||||
    // Garbage in, garbage out some would say...
 | 
			
		||||
    env.HTTP_PROXY = 'crazy without colon slash slash';
 | 
			
		||||
    testProxyUrl(env, 'http://crazy without colon slash slash', 'http://wow');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('https_proxy and HTTPS_PROXY', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    // Assert that there is no fall back to http_proxy
 | 
			
		||||
    env.HTTP_PROXY = 'http://unexpected.proxy';
 | 
			
		||||
    testProxyUrl(env, '', 'https://example');
 | 
			
		||||
 | 
			
		||||
    env.HTTPS_PROXY = 'http://https-proxy';
 | 
			
		||||
    testProxyUrl(env, 'http://https-proxy', 'https://example');
 | 
			
		||||
 | 
			
		||||
    // jscs:disable requireCamelCaseOrUpperCaseIdentifiers
 | 
			
		||||
    env.https_proxy = 'http://priority';
 | 
			
		||||
    // jscs:enable requireCamelCaseOrUpperCaseIdentifiers
 | 
			
		||||
    testProxyUrl(env, 'http://priority', 'https://example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('ftp_proxy', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    // Something else than http_proxy / https, as a sanity check.
 | 
			
		||||
    env.FTP_PROXY = 'http://ftp-proxy';
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, 'http://ftp-proxy', 'ftp://example');
 | 
			
		||||
    testProxyUrl(env, '', 'ftps://example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('all_proxy', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.ALL_PROXY = 'http://catch-all';
 | 
			
		||||
    testProxyUrl(env, 'http://catch-all', 'https://example');
 | 
			
		||||
 | 
			
		||||
    // jscs:disable requireCamelCaseOrUpperCaseIdentifiers
 | 
			
		||||
    env.all_proxy = 'http://priority';
 | 
			
		||||
    // jscs:enable requireCamelCaseOrUpperCaseIdentifiers
 | 
			
		||||
    testProxyUrl(env, 'http://priority', 'https://example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('all_proxy without scheme', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.ALL_PROXY = 'noscheme';
 | 
			
		||||
    testProxyUrl(env, 'http://noscheme', 'http://example');
 | 
			
		||||
    testProxyUrl(env, 'https://noscheme', 'https://example');
 | 
			
		||||
 | 
			
		||||
    // The module does not impose restrictions on the scheme.
 | 
			
		||||
    testProxyUrl(env, 'bogus-scheme://noscheme', 'bogus-scheme://example');
 | 
			
		||||
 | 
			
		||||
    // But the URL should still be valid.
 | 
			
		||||
    testProxyUrl(env, '', 'bogus');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy empty', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTPS_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    // NO_PROXY set but empty.
 | 
			
		||||
    env.NO_PROXY = '';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'https://example');
 | 
			
		||||
 | 
			
		||||
    // No entries in NO_PROXY (comma).
 | 
			
		||||
    env.NO_PROXY = ',';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'https://example');
 | 
			
		||||
 | 
			
		||||
    // No entries in NO_PROXY (whitespace).
 | 
			
		||||
    env.NO_PROXY = ' ';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'https://example');
 | 
			
		||||
 | 
			
		||||
    // No entries in NO_PROXY (multiple whitespace / commas).
 | 
			
		||||
    env.NO_PROXY = ',\t,,,\n,  ,\r';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'https://example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=example (single host)', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = 'example';
 | 
			
		||||
    testProxyUrl(env, '', 'http://example');
 | 
			
		||||
    testProxyUrl(env, '', 'http://example:80');
 | 
			
		||||
    testProxyUrl(env, '', 'http://example:0');
 | 
			
		||||
    testProxyUrl(env, '', 'http://example:1337');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://sub.example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://prefexample');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example.no');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://a.b.example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://host/example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=sub.example (subdomain)', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = 'sub.example';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example:80');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example:0');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example:1337');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://no.sub.example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://sub-example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example.sub');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=example:80 (host + port)', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = 'example:80';
 | 
			
		||||
    testProxyUrl(env, '', 'http://example');
 | 
			
		||||
    testProxyUrl(env, '', 'http://example:80');
 | 
			
		||||
    testProxyUrl(env, '', 'http://example:0');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example:1337');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://sub.example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://prefexample');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example.no');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://a.b.example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=.example (host suffix)', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = '.example';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example:80');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example:1337');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example:80');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example:1337');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://prefexample');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example.no');
 | 
			
		||||
    testProxyUrl(env, '', 'http://a.b.example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=*', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
    env.NO_PROXY = '*';
 | 
			
		||||
    testProxyUrl(env, '', 'http://example.com');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=*.example (host suffix with *.)', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = '*.example';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example:80');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example:1337');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example:80');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example:1337');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://prefexample');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example.no');
 | 
			
		||||
    testProxyUrl(env, '', 'http://a.b.example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=*example (substring suffix)', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = '*example';
 | 
			
		||||
    testProxyUrl(env, '', 'http://example');
 | 
			
		||||
    testProxyUrl(env, '', 'http://example:80');
 | 
			
		||||
    testProxyUrl(env, '', 'http://example:1337');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example:80');
 | 
			
		||||
    testProxyUrl(env, '', 'http://sub.example:1337');
 | 
			
		||||
    testProxyUrl(env, '', 'http://prefexample');
 | 
			
		||||
    testProxyUrl(env, '', 'http://a.b.example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example.no');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://host/example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=.*example (arbitrary wildcards are NOT supported)',
 | 
			
		||||
      function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = '.*example';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://sub.example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://sub.example');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://prefexample');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://x.prefexample');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://a.b.example');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=[::1],[::2]:80,10.0.0.1,10.0.0.2:80 (IP addresses)',
 | 
			
		||||
      function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = '[::1],[::2]:80,10.0.0.1,10.0.0.2:80';
 | 
			
		||||
    testProxyUrl(env, '', 'http://[::1]/');
 | 
			
		||||
    testProxyUrl(env, '', 'http://[::1]:80/');
 | 
			
		||||
    testProxyUrl(env, '', 'http://[::1]:1337/');
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'http://[::2]/');
 | 
			
		||||
    testProxyUrl(env, '', 'http://[::2]:80/');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://[::2]:1337/');
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'http://10.0.0.1/');
 | 
			
		||||
    testProxyUrl(env, '', 'http://10.0.0.1:80/');
 | 
			
		||||
    testProxyUrl(env, '', 'http://10.0.0.1:1337/');
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'http://10.0.0.2/');
 | 
			
		||||
    testProxyUrl(env, '', 'http://10.0.0.2:80/');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://10.0.0.2:1337/');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=127.0.0.1/32 (CIDR is NOT supported)', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = '127.0.0.1/32';
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://127.0.0.1');
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://127.0.0.1/32');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy=127.0.0.1 does NOT match localhost', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = '127.0.0.1';
 | 
			
		||||
    testProxyUrl(env, '', 'http://127.0.0.1');
 | 
			
		||||
    // We're not performing DNS queries, so this shouldn't match.
 | 
			
		||||
    testProxyUrl(env, 'http://proxy', 'http://localhost');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy with protocols that have a default port', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.WS_PROXY = 'http://ws';
 | 
			
		||||
    env.WSS_PROXY = 'http://wss';
 | 
			
		||||
    env.HTTP_PROXY = 'http://http';
 | 
			
		||||
    env.HTTPS_PROXY = 'http://https';
 | 
			
		||||
    env.GOPHER_PROXY = 'http://gopher';
 | 
			
		||||
    env.FTP_PROXY = 'http://ftp';
 | 
			
		||||
    env.ALL_PROXY = 'http://all';
 | 
			
		||||
 | 
			
		||||
    env.NO_PROXY = 'xxx:21,xxx:70,xxx:80,xxx:443';
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'http://xxx');
 | 
			
		||||
    testProxyUrl(env, '', 'http://xxx:80');
 | 
			
		||||
    testProxyUrl(env, 'http://http', 'http://xxx:1337');
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'ws://xxx');
 | 
			
		||||
    testProxyUrl(env, '', 'ws://xxx:80');
 | 
			
		||||
    testProxyUrl(env, 'http://ws', 'ws://xxx:1337');
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'https://xxx');
 | 
			
		||||
    testProxyUrl(env, '', 'https://xxx:443');
 | 
			
		||||
    testProxyUrl(env, 'http://https', 'https://xxx:1337');
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'wss://xxx');
 | 
			
		||||
    testProxyUrl(env, '', 'wss://xxx:443');
 | 
			
		||||
    testProxyUrl(env, 'http://wss', 'wss://xxx:1337');
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'gopher://xxx');
 | 
			
		||||
    testProxyUrl(env, '', 'gopher://xxx:70');
 | 
			
		||||
    testProxyUrl(env, 'http://gopher', 'gopher://xxx:1337');
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'ftp://xxx');
 | 
			
		||||
    testProxyUrl(env, '', 'ftp://xxx:21');
 | 
			
		||||
    testProxyUrl(env, 'http://ftp', 'ftp://xxx:1337');
 | 
			
		||||
  });
 | 
			
		||||
 | 
			
		||||
  describe('no_proxy should not be case-sensitive', function() {
 | 
			
		||||
    var env = {};
 | 
			
		||||
    env.HTTP_PROXY = 'http://proxy';
 | 
			
		||||
    env.NO_PROXY = 'XXX,YYY,ZzZ';
 | 
			
		||||
 | 
			
		||||
    testProxyUrl(env, '', 'http://xxx');
 | 
			
		||||
    testProxyUrl(env, '', 'http://XXX');
 | 
			
		||||
    testProxyUrl(env, '', 'http://yyy');
 | 
			
		||||
    testProxyUrl(env, '', 'http://YYY');
 | 
			
		||||
    testProxyUrl(env, '', 'http://ZzZ');
 | 
			
		||||
    testProxyUrl(env, '', 'http://zZz');
 | 
			
		||||
  });
 | 
			
		||||
});
 | 
			
		||||
		Reference in New Issue
	
	Block a user