v1.16.0 — May 2, 2026
This release adds support for the QUERY HTTP method and a new ECONNREFUSED error constant, lands a substantial wave of HTTP, fetch, and XHR adapter bug fixes around redirects, aborts, headers, and timeouts, and welcomes 23 new contributors.
⚠️ Notable Changes
A handful of fixes in this release are either security-adjacent or change observable behaviour. Please review before upgrading:
- Fetch adapter now enforces
maxBodyLength and maxContentLength. These limits were silently ignored on the fetch adapter prior to 1.16.0 — anyone relying on them as a safety net (DoS protection, accidental large uploads) had no protection. (#10795 )
- Proxy requests now preserve user-supplied
Host headers. Previously, the proxy path could overwrite a custom Host. Virtual-host-style routing through a proxy will now behave correctly. (#10822 )
- Basic auth credentials embedded in URLs are now URL-decoded. If you have percent-encoded credentials in a URL (e.g.
https://user:p%40ss@host), the decoded value is what now goes on the wire. (#10825 )
parseProtocol now strictly requires a colon in the protocol separator. Strings that loosely parsed as protocols before may no longer match. (#10729 )
- Deprecated
unescape() replaced with modern UTF-8 encoding. Non-ASCII URL handling is now spec-correct; consumers depending on legacy unescape() quirks may see different output bytes. (#7378 )
transformRequest input typing change was reverted. The typing change introduced in #10745 was reverted in #10810 after follow-up review — net behavior is unchanged from 1.15.2. (#10745 , #10810 )
🚀 New Features
- QUERY HTTP Method: Added support for the QUERY HTTP method across adapters and type definitions. (#10802 )
- ECONNREFUSED Error Constant: Exposed
ECONNREFUSED as a constant on AxiosError so callers can match connection-refused failures without comparing string literals (closes #6485). (#10680 )
- Encode Helper Export: Exported the internal
encode helper from buildURL so userland param serializers can reuse the same encoding logic that axios uses internally. (#6897 )
🐛 Bug Fixes
- HTTP Adapter — Redirects & Headers: Cleared stale headers when a redirect targets a no-proxy host, fixed the redirect listener chain so listeners no longer stack across hops, restored the missing
requestDetails argument on beforeRedirect, preserved user-supplied Host headers when forwarding through a proxy, and properly URL-decoded basic auth credentials. (#10794 , #10800 , #6241 , #10822 , #10825 )
- HTTP Adapter — Streams & Timeouts: Preserved the partial response object on
AxiosError when a stream is aborted after headers arrive, honoured the timeout option during the connect phase when redirects are disabled, and resolved an unsettled-promise hang when an aborted request was combined with compression and maxRedirects: 0. (#10708 , #10819 , #7149 )
- Fetch Adapter: Enforced
maxBodyLength / maxContentLength in the fetch adapter, set the User-Agent header to match the HTTP adapter, preserved the original abort reason instead of replacing it with a generic error, and deferred global access so importing the module no longer throws a TypeError in restricted environments. (#10795 , #10772 , #10806 , #7260 )
- XHR Adapter: Unsubscribed the
cancelToken and AbortSignal listeners on the error, timeout, and abort code paths to prevent leaked subscriptions. (#10787 )
- Error Handling: Attached the parsed response to
AxiosError when JSON.parse fails inside dispatchRequest, prevented settle from emitting undefined error codes, and tightened the parseProtocol regex to require a colon in the protocol separator. (#10724 , #7276 , #10729 )
- Types & Exports: Aligned the CommonJS
CancelToken typings with the ESM build, fixed a compiler error caused by RawAxiosHeaders, and re-exported create from the package index. (#7414 , #6389 , #6460 )
- UTF-8 Encoding: Replaced the deprecated
unescape() call with a modern UTF-8 encoding implementation. (#7378 )
- Misc Cleanup: Resolved a batch of small inconsistencies and gadget-level issues across the codebase. (#10833 )
🔧 Maintenance & Chores
- Refactor — ES6 Modernisation: Modernised the
utils module and XHR adapter to use ES6 features, and tidied the multipart boundary error message. (#10588 , #7419 )
- Tests: Hardened the HTTP test server lifecycle to fix flaky
FormData EPIPE failures, fixed Win32 platform support for the pipe tests, and corrected an incorrect test assumption. (#10820 , #10791 , #10796 )
- Docs: Documented
paramsSerializer.encode for strict RFC 3986 query encoding, updated the parseReviver TypeScript definitions and configuration docs for ES2023, added timeout guidance to the README's first async example, and expanded notes around the recent type changes. (#10821 , #10782 , #10759 , #10804 )
- Reverted: Reverted the
transformRequest input typing change from #10745 after follow-up review. (#10745 , #10810 )
- Dependencies: Bumped
actions/setup-node, the github-actions group, and postcss (in /docs) to their latest versions. (#10785 , #10813 , #10814 )
- Release: Updated changelog and packages, and prepared the 1.16.0 release. (#10790 , #10834 )
🌟 New Contributors
We are thrilled to welcome our new contributors. Thank you for helping improve axios:
... (truncated)
Bumps axios from 1.15.0 to 1.16.0.
Release notes
Sourced from axios's releases.
... (truncated)
Changelog
Sourced from axios's changelog.
... (truncated)
Commits
df53d7dchore(release): prepare release 1.16.0 (#10834)9d92bcdfix: gadgets and smaller issues (#10833)5107ee6fix: prevent undefined error codes in settle (#7276)e573499fix(fetch): defer global access in fetch adapter (#7260)ad68e1afix(http): honor timeout during connect without redirects (#10819)2a51828fix(http): decode URL basic auth credentials (#10825)0e8b6bbfix(http): preserve user-supplied Host header when forwarding through a proxy...79f39e1docs: document paramsSerializer.encode for strict RFC 3986 query encoding (#1...0fe3a5f[Docs/Types] UpdateparseReviverTypeScript definitions for ES2023 and add ...cd6737fchore: matches the sibling responseStream.on(aborted) handler and added tests...Dependabot compatibility score
Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
@dependabot rebasewill rebase this PR@dependabot recreatewill recreate this PR, overwriting any edits that have been made to it@dependabot show <dependency name> ignore conditionswill show all of the ignore conditions of the specified dependency@dependabot ignore this major versionwill close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this minor versionwill close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)@dependabot ignore this dependencywill close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)You can disable automated security fix PRs for this repo from the Security Alerts page.