http-proxy-agent
May 24, 2026 · View on GitHub
9.1.0
Minor Changes
-
d8f2926: Adds
proxyConnectevent emission tohttp-proxy-agentfor parity withhttps-proxy-agent. The event is emitted on both the request and the agent instance when the socket connects to the proxy server. -
84e85ed: Add
onProxyAuthcallback andnegotiateoption for Kerberos/SPNEGO proxy authentication- Extract shared Negotiate/SPNEGO auth logic into new
proxy-agent-negotiatepackage - Added optional
onProxyAuthasync callback toHttpsProxyAgentandHttpProxyAgentoptions - When the proxy responds with 407 Proxy-Authentication Required, the callback is invoked with the response and auth scheme
- The callback returns headers (e.g.
Proxy-Authorization) to retry the request with - Added
negotiate: trueoption that uses thekerberospackage for automatic Negotiate/SPNEGO auth - Added
kerberosas an optional peer dependency ofproxy-agent-negotiate - Extended the
proxytest package to supportauthenticate: 'negotiate'mode for mock testing
- Extract shared Negotiate/SPNEGO auth logic into new
-
3ebf4b2: Add
proxyevent emission on the request object for all proxy agents. After the proxy connection is established, the request emits aproxyevent with{ proxy, socket }whereproxyis the proxy URL string. This is useful for debugging and logging which proxy was used for a connection.
Patch Changes
- Updated dependencies [84e85ed]
- proxy-agent-negotiate@1.1.0
9.0.0
Major Changes
- 7d12b51: Set minimum Node.js version to 20
Patch Changes
- 7ca27d0: Simplify package.json exports to remove unnecessary imports restriction
- Updated dependencies [ca12148]
- Updated dependencies [7d12b51]
- Updated dependencies [7ca27d0]
- agent-base@9.0.0
8.0.0
Major Changes
- 9c92c09: Convert to ESM. All packages now use
"type": "module"and compile to ESM output instead of CommonJS.
Patch Changes
- Updated dependencies [9c92c09]
- agent-base@8.0.0
7.0.2
Patch Changes
- b88ab46: Import
urlinstead ofnode:url🤷♂️
7.0.1
Patch Changes
- c3c405e: Add missing
URLtype import
7.0.0
Major Changes
-
b3860aa: Remove
secureProxygetterIt was not meant to be a public property. If you were using it, just use
agent.proxy.protocol === 'https:'instead.
6.1.1
Patch Changes
- eb6906b: Fix
keepAlive: true - Updated dependencies [da699b1]
- agent-base@7.1.0
6.1.0
Minor Changes
- 1069932: Added "headers" option
Patch Changes
- Updated dependencies [66b4c63]
- agent-base@7.0.2
6.0.1
Patch Changes
- 7674748: Update
@types/nodeto v14.18.45 - Updated dependencies [7674748]
- agent-base@7.0.1
6.0.0
Major Changes
- d99a7c8: Major version bump for all packages
- ⚠️ This is a breaking change! The
HttpProxyAgentconstructor argument has been split into two arguments.
- ⚠️ This is a breaking change! The
Upgrading from 5.x to 6.x
In version 5.x, the HttpProxyAgent constructor took a single argument of either (A) a string, or (B) an object matching the output of
the deprecated url.parse() method
and various extra options.
Now the constructor takes two separate arguments:
- Argument 1: Either (A) a
string, or (B) a WHATWGURLobject - Argument 2 (optional): An object with standard
http.Agent,net.TcpNetConnectOpts, andtls.ConnectionOptionsproperties.
If you were using an object argument in 5.x, you'll need to change the first argument to match the structure of the URL class, and move
any other options to the second argument.
5.x usage:
const agent = new HttpProxyAgent({
protocol: 'https:',
host: 'myproxy.mydomain.com'
port: '1234',
auth: 'proxyUser:proxyPass',
timeout: 1000
});
Updated 6.x usage:
const agent = new HttpProxyAgent(
{
protocol: 'https:',
hostname: 'myproxy.mydomain.com'
port: '1234',
username: 'proxyUser',
password: 'proxyPass'
},
{
timeout: 1000
}
);
Minor Changes
- 4333067: Add support for core
keepAlive: true
Patch Changes
- c169ced: Convert mocha tests to jest for all packages
- Updated dependencies [c169ced]
- Updated dependencies [d99a7c8]
- Updated dependencies [4333067]
- agent-base@7.0.0