A proxy adapter for debugging httpclient on egg.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
config
test
.autod.conf.js
.eslintignore
.eslintrc
.gitignore
.travis.yml
History.md
LICENSE
README.md
README.zh_CN.md
app.js
appveyor.yml
package.json

README.md

egg-development-proxyagent

NPM version build status Test coverage David deps Known Vulnerabilities npm download

Nowadays lots of services are built upon HTTP protocol. So it's quite common to invoke backend services based on HTTP.

There is a built-in httpclient in Egg framework so that we can use it to invoke HTTP services easily.

This plugin provides a way of capturing HTTP request for debugging purpose.

Install

npm i egg-development-proxyagent --save-dev
// config/plugin.local.js
exports.proxyagent = {
  enable: true,
  package: 'egg-development-proxyagent',
};

Usage

This plugin will take effect only in local env. Because it overrides the agent and httpsAgent of httpclient, so it will work for every request. And also you can delegate HTTPS requests via HTTP.

http_proxy or HTTP_PROXY environment variable will be used if set in Bash. Or you can specify it when you start app:

$ http_proxy=http://127.0.0.1:8888 node index.js

Capturing HTTPS Traffic

By default the http_proxy(or HTTP_PROXY) mentioned above will be passed to httpsAgent of urllib, and rejectUnauthorized = false will be set.

However, when using self-signed certificate we need to configure the certificate, shown as follows:

ca String | Buffer | Array - An array of strings or Buffers of trusted certificates. If this is omitted several well known "root" CAs will be used, like VeriSign. These are used to authorize connections. Notes: This is necessary only if the server uses the self-signed certificate

// config/config.default.js
exports.proxyagent = {
  ca: 'xxxxxxxxxxxx',
};

Capturing Tool

Note: Capturing tool is not in this plugin, you can use one of them below:

  • charles
  • fiddler
  • anyproxy is a capturing tool writtern in node. It provides a web console, it's a good replacement of charles.
$ npm install anyproxy -g
$ anyproxy --port 8888
$ open http://localhost:8002

Screenshot:

anyproxy

Questions & Suggestions

Please open an issue here.

License

MIT