npm / httpxy

httpxy

What changed in httpxy 0.2 to 0.5, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.

7 breaking14 new APIs and options1 performance1 behavior and defaults1 tooling26 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

httpxy 0.515 changes

Forces connection: close on chunked upstream requests.
0.5.5release notes
Reverts trailing slash preservation in joinURL.
0.5.3release notes
ProxyServer and proxyFetch now share keep-alive HTTP and HTTPS agents, with 256 max sockets and 64 max free sockets; set agent: false to restore per-request connections.
0.5.0release notes

Declare pathname on ProxyTargetDetailed so developers can use the field in typed code.
0.5.4release notes
Error events forward the target URL as their 4th argument.
0.5.2release notes
Adds the server listeningCallback API.
0.5.1release notes

ReadableStream and Blob request bodies are piped directly upstream instead of buffered; bodies are still buffered for 307/308 replay when followRedirects is enabled.
0.5.0release notes

Retains the relative protocol in the redirect location header.
0.5.5release notes
Preserve transfer-encoding on chunked DELETE and OPTIONS requests.
0.5.4release notes
Hosts are derived from hostname for plain object targets, and IPv6 literals are bracketed.
0.5.2release notes
The trailing slash is preserved when proxying a root path to a sub-path target.
0.5.2release notes
Headers are no longer set to undefined values.
0.5.1release notes
Uses agents: false for WebSocket upgrades.
0.5.1release notes
Fixes HTTP/2 header merging to preserve the host override order.
0.5.0release notes
Outgoing requests are destroyed when a readable request body stream errors.
0.5.0release notes

The distribution is ESM-only, affecting how consumers load the package.
0.4.0release notes
The deprecated req.abort() API is removed.
0.4.0release notes
The deprecated aborted listener is removed.
0.4.0release notes

Client disconnects emit econnreset.
0.4.0release notes
WebSocket proxying skips writes to a closed socket on a non-upgrade response.
0.4.0release notes
Response stream errors are handled on failed WebSocket upgrades.
0.4.0release notes
Synchronous exceptions in middleware passes are caught.
0.4.0release notes
The target URL query string is preserved during path merging.
0.4.0release notes
proxyUpgrade preserves the wss:// protocol and fixes error handling.
0.4.0release notes
Redirect host rewriting now handles object targets.
0.4.0release notes
Redirect rewriting now handles relative Location URLs and includes HTTP 303.
0.4.0release notes
Invalid response header characters are handled gracefully, and empty header names are skipped.
0.4.0release notes
Undefined target values no longer overwrite SSL options.
0.4.0release notes
The transfer-encoding header is stripped on 204 and 304 responses.
0.4.0release notes
Middleware no longer appends duplicate x-forwarded-* header values.
0.4.0release notes

A standalone proxyUpgrade utility is available for use.
0.3.1release notes
Implements native followRedirects support for web-incoming requests.
0.3.0release notes
Adds proxyFetch.
0.3.0release notes

Aborts the proxy request when the client disconnects.
0.3.0release notes
Emits a proxy error when a listener exists and rejects only when the error is unhandled.
0.3.0release notes
Destroys the request socket on timeout.
0.3.0release notes
Preserves multiple consecutive slashes in the request URL.
0.3.0release notes
Ensures the outgoing path has a leading slash.
0.3.0release notes
Handles client socket errors before the upstream upgrade.
0.3.0release notes

The server event type map is now generic, allowing its event types to be customized.
0.2.1release notes

Proxy server events are now typed, improving type information for developers working with them.
0.2.0release notes