npm / proxy
proxy
What changed in proxy 3 to 4, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-24.
3 breaking4 new APIs and options1 behavior and defaults
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initproxy 47 changes
Breaking changes 2
URLs longer than 4096 characters are rejected with HTTP 414 to prevent potential denial of service from excessively long inputs.
The minimum supported Node.js version is now 20.
New APIs and options 4
proxy-agent-negotiatehaskerberosas an optional peer dependency for automatic Negotiate/SPNEGO authentication.Setting
negotiate: trueenables automatic Negotiate/SPNEGO proxy authentication using thekerberospackage.HttpsProxyAgent and HttpProxyAgent accept an async callback invoked when the proxy responds with 407; it can return headers for retrying the request.
A new package provides shared Negotiate/SPNEGO authentication logic for proxy agents.
Behavior and default changes 1
Package exports no longer impose an unnecessary imports restriction.
proxy 31 changes
Breaking changes 1
All packages now use ESM and compile to ESM output instead of CommonJS, affecting how developers consume the packages.