Repository navigation
Releases
v1.21.1
v1.21.1 — November 9, 2026
This release raises the minimum follow-redirects version to fix a published CVE, fixes a Next.js prerendering failure caused by the response duration timer, corrects the getAdapter typings, and includes documentation corrections, new test coverage, CI runner changes and dependency updates.
🔒 Security Fixes
- follow-redirects: Raised the
follow-redirectsrange from^1.16.0to^1.16.2to fix CVE-2026-116689 (GHSA-mrwp-f3q8-3g9p). In the vulnerable versions,sensitiveHeadersarrays from another realm were ignored and custom credentials could follow redirects. Only the Node.js HTTP adapter is affected, and there are no API changes. (#11410)
🐛 Bug Fixes
- Response Duration:
dispatchRequestnow measuresresponse.durationwithperformance.now()and usesDate.now()only whenperformance.now()isn't available. In v1.21.0, any axios request from a Server Component failed Next.js production builds with Cache Components (cacheComponents: true), because Next.js rejectsDate.now()while prerendering. The duration is still a whole number of milliseconds, and system clock changes no longer affect it. (#11411) - TypeScript:
getAdapternow accepts an optionalconfig?: AxiosRequestConfiginindex.d.tsandindex.d.cts, matching what it does at runtime. You can now callgetAdapter('fetch', { env: { fetch: myFetch } })without a cast. (#11404)
🔧 Maintenance & Chores
-
Documentation Corrections: Brought the README and docs site in line with how axios actually behaves:
transformRequestruns for every method, and transformers receive(data, headers, status).responseTypeandContent-Typehave no default value.AxiosHeaders#getand#normalizeare described correctly.- Errors should be identified with
axios.isAxiosError(), not byname. - The error tables now list
ECONNREFUSEDandERR_FORM_DATA_DEPTH_EXCEEDED, and note that FormData parsing has a fixed depth limit thatmaxDepthdoesn't change. - New notes cover what
redactdoesn't scan, which adapters enforcemaxContentLength/maxBodyLength, and howformToJSON()handles field name collisions.
-
Docs Site: Added a Partners page, a shared card design for sponsors and partners, a Namespace sponsor badge, and a blog whose first post announces HeroDevs Never-Ending Support for Axios v0. Also applied the v1.20.0/v1.21.0 release notes to the docs, and fixed internal links in the es, fr and zh translations so they keep their locale prefix. (#11390, #11399, #11400, #11412, #11401)
-
Test Coverage: Added cancellation tests across the HTTP, fetch and XHR adapters. They cover
AbortSignal,CancelToken, cancelling while a request interceptor is pending, and timeout precedence. Also added tests forno_proxyedge cases inshouldBypassProxy, such as internationalized domain names, malformed CIDR and IPv4 entries, and port-qualified entries. Neither changes runtime behavior. (#11376, #11431) -
CI: GitHub Actions jobs now run on Namespace runners. The npm publish job stays on GitHub-hosted runners, because npm provenance and trusted publishing (OIDC) only work there. (#11396)
-
Dependencies: Updated development and tooling dependencies, including
vitestand@vitest/*(to 5.x at the root),typescript(7.x at the root),vite,rollup,eslint,playwright,@commitlint/*,@rollup/plugin-alias,@rollup/plugin-terser,body-parser,multer,serialize-javascript,fast-uri,qs,zizmorcore/zizmor-action, andfollow-redirectsin/docs. (#11383, #11375, #11372, #11345, #11392, #11387, #11386, #11385, #11391, #11388, #11395, #11421, #11422, #11426) -
Release: Prepared the 1.21.1 release. (#11435)
🌟 New Contributors
We are thrilled to welcome our new contributors. Thank you for helping improve axios:
v0.35.0
v0.35.0 — November 2, 2026
This release aligns request option handling, parameter validation and form serialization across Node and browser runtimes on the v0.x line, with some stricter validation, and moves v0.x CI onto Namespace runners.
⚠️ Breaking Changes & Deprecations
- Parameter Depth Limit:
paramsnested deeper than 100 levels now reject withERR_BAD_OPTION_VALUE. (#11243) - Form Index Serialization: Sparse arrays and non-canonical numeric form indexes, such as
01, now serialize as keyed objects instead of being collapsed into arrays. (#11243) - Native Proxy Agents: On runtimes with native environment proxy support, agents that override native pool-management or TLS-session lifecycle hooks now reject with
ERR_BAD_OPTION_VALUE. Use an agent constructed withoutproxyEnvfor these configurations. Plain subclasses are still supported, and public type signatures are unchanged. (#11243)
🐛 Bug Fixes
- Connection Pools & Agents: When axios selects or reuses a direct connection pool, it now keeps live native agent options, pool controls, and custom connection and pool-name hooks. Only the selected protocol's agent is adapted, including on redirects, and the configured agent's
destroy()also cleans up its direct pool. Cached direct pools stay selected after public proxy options are removed or replaced. (#11243) - Parameter Validation: Enumerable custom-object
paramsroots are now validated consistently before merging. Array validation checks canonical numeric elements, including hidden and inherited slots, and ignores named metadata. Legacy runtimes use bounded scans and never mutate caller objects. (#11243) - Form Serialization: Hidden and inherited array-like numeric indexes are unwrapped, sparse arrays are preserved, and non-canonical numeric field names survive JSON serialization. Inherited read-only numeric slots no longer block conversion or multipart serialization. (#11243)
- FileList Handling:
FileListvalues are copied by index without relying on host-object reflection, and are converted before multipart iteration. Incomplete collections fall back to the unconverted-value path instead of emitting a partial list. (#11243) - Upload & Data URL Limits: Streamed uploads honor the configured byte limit across transports. Data URL size checks follow the decoder's encoding rules, including bare
data:base64,...metadata. (#11243) - Legacy Runtime Compatibility: The affected browser helpers stay compatible with ES5 number and reflection APIs and no longer depend on property enumeration order. (#11243)
🔧 Maintenance & Chores
- CI Infrastructure: v0.x workflow jobs now run on the
namespace-profile-axiosNamespace runner profile. The npm publish job stays on GitHub-hosted runners so provenance and trusted publishing keep working. Firefox is installed through a SHA-pinnedbrowser-actions/setup-firefoxstep in the CI and release-branch workflows for Karma browser tests. (#11398, #11416) - Release: Bumped the version to 0.35.0. (#11417)
v1.21.0
v1.21.0 — October 21, 2026
This release adds response timing and opt-in UTF-8 Basic authentication, improves request handling across runtimes, and changes how header defaults are recognized.
⚠️ Breaking Changes & Deprecations
- Header Defaults: Only plain objects, null-prototype maps, and compatible
AxiosHeadersinstances are treated as common or method-specific defaults; literal headers such asLinkare now preserved. Applications using custom class instances as defaults must convert them to plain maps, for example{ post: { ...customDefaults } }, or compatibleAxiosHeaders. Otherwise, those instances become literal header values, including on requests using other methods. (#11156)
🚀 New Features
- Response Timing: Added
response.duration, in milliseconds, including onerror.responsewhen present. Timing measures adapter execution and excludes interceptors and transforms; streamed responses stop timing when the stream becomes available. Axios replaces any existingdurationvalue supplied by a custom adapter. (#11214) - UTF-8 Basic Authentication: Added
transitional.encodeBasicAuthUsername: trueto support Unicode usernames in XHR and Fetch requests. The option defaults tofalse, preserving existing authentication behavior; applications opting in should supply the original Unicode username and remove manual pre-encoding workarounds. (#11159)
🐛 Bug Fixes
- Fetch Compatibility: Restored requests in runtimes such as Cloudflare Workers that reject the implicit
cache: 'default', while preserving explicit caller settings. Response-size failures now retain their originalERR_BAD_RESPONSEand request context when runtime wrappers replace the underlying stream error. (#11194, #11179) - Runtime Consistency: Aligned encoded-byte size accounting, multipart uploads, proxy routing, same-origin resolution, parameter merging, and form serialization across adapters. Circular parameters now reject with
ERR_BAD_OPTION_VALUE, and sparse or non-index numeric form fields serialize as keyed objects. Withproxy: false, nativeproxyEnvagents using unsupported pool-management or TLS-session lifecycle overrides now reject withERR_BAD_OPTION_VALUE; construct those agents withoutproxyEnv. (#11242) - Header Handling: Preserved headers named
__proto__using safe casing without changing theAxiosHeadersinstance prototype. Function matchers inhas(),delete(), andclear()now receive the headers instance asthis, matching their declared contract. (#11134, #11216) - URL and Data URL Parsing: Accepted case-insensitive supported URL schemes and Base64 markers, and corrected decoding of percent-encoded Base64 data URLs. Node data URL allocation estimates remain aligned with decoding so configured size limits apply before allocation. (#11138, #11163, #11294)
- Error Diagnostics: Preserved short reconstructed request stacks and appended wrapped error stacks under
Caused by:so tooling that reads onlyerror.stackretains the original failure context. (#11132, #11142) - Interceptor Removal: Restored removal through canonical numeric-string interceptor IDs, including after registry compaction. (#11139)
- Proxy TLS: HTTPS CONNECT tunnels now apply current origin TLS options from an explicit
httpsAgent, or fromhttps.globalAgentwhen no explicit agent is supplied. This preserves process-wide custom CA settings through proxy tunnels. (#11178) - XHR Lifecycle: Used asynchronous Cookie Store reads for XSRF tokens where supported, preserving cookie fallback, timeout accounting, and cancellation. Upload and download progress listeners are now removed on completion, failure, timeout, and cancellation. (#11166, #11225)
- HTTP/2 Sessions: Stopped reusing sessions immediately after GOAWAY and prevented draining sessions from scheduling idle timers that could delay process exit. (#11210)
- TypeScript Declarations: Exposed the response-default marker as a public type to resolve
TS2527when consumers emit declarations involving unresolved response generics, covering both ESM and CommonJS. (#11125)
🔧 Maintenance & Chores
- Configuration Performance: Reduced request configuration merge overhead, particularly for requests with many headers, while preserving merge semantics and prototype-pollution guards. (#11208)
- Same-Origin Checks: Removed obsolete Internet Explorer detection without changing origin decisions in supported environments. (#11174)
- Dependencies: Updated
follow-redirectsto 1.16.1 and refreshed development, documentation, test, and GitHub Actions dependencies. Removed unuseddayjsfrom the docs package, rootchalk, andchaifrom CJS module tests. (#11169, #11188, #11189, #11195, #11212, #11213, #11218, #11220, #11221, #11230, #11234, #11244, #11245, #11266, #11267, #11268, #11269, #11270, #11271, #11272, #11298, #11302, #11303, #11304, #11305, #11306, #11313, #11321, #11322, #11323, #11342) - Documentation: Fixed interceptor test links, updated README CDN examples to the published 1.20.0 bundle, and corrected guidance on interceptor options and request lifecycle ordering. (#11228, #11149, #11335)
- Contributor Workflow: Consolidated agent instructions in
AGENTS.md, standardized PR labels, required prerelease notes and validation evidence, and clarified thatnpm testrequires installed Playwright browsers. (#11238, #11273, #11223, #11284) - Sponsors and Support: Added HeroDevs, Code for Japan, and Sweepico sponsor listings, refreshed sponsor data, and documented extended security support for Axios v0. (#11222, #11249, #11252, #11341)
- Proxy Regression Coverage: Added a long dotted request-hostname test for
NO_PROXYhandling, extending coverage of an existing denial-of-service fix. (#11235) - Release Preparation: Updated package version metadata for 1.21.0. (#11346)
🌟 New Contributors
Welcome to our 24 new contributors. Thank you for helping improve Axios:
- @lazerg (#11194)
- @QIU-Guanzong (#11228)
- @Iams4kura (#11125)
- @vjymisal0 (#11179)
- @jarrensj (#11238)
- @LineGu (#11132)
- @luantaraschi (#11134)
- @Cyberhet (#11284)
- @nyxst4ck (#11138)
- @windcrestai (#11163)
- ...
v0.34.0
v0.34.0 — September 13, 2026
This release hardens request configuration and proxy handling, adds caller diagnostics and cancellation context, and tightens TypeScript header types.
⚠️ Breaking Changes & Deprecations
- Header Types: TypeScript now rejects header values that are Promises, functions, or objects with custom toString() methods. Resolve promises, call functions, or explicitly convert objects before assigning header values. Supported scalar, array, and grouped headers remain available. (#11209)
- Proxy Routing: NO_PROXY / no_proxy entries now support IPv4 and IPv6 CIDR ranges. Previously ineffective ranges now cause matching IP destinations to bypass the proxy; review existing ranges when upgrading. (#11172)
🔒 Security Fixes
- Request Configuration: Prevent inherited properties from influencing form serializer options, default request methods, headers on interceptor-returned configs, and HTTP redirect hooks. Applications relying on inherited options must define those values as own properties. (#11172)
- Hostname Processing: Replace quadratic regular-expression backtracking in proxy bypass hostname normalization with a linear scan, preventing excessive processing of crafted redirect hostnames. (#11172)
🚀 New Features
- Caller Diagnostics: Enable captureCallerStack: true on a request or instance to append original caller frames to asynchronous error stacks. Disabled by default. (#11209)
- Cancellation Context: Preserve AbortSignal.reason as CanceledError.reason, including objects and falsy values. Native and structural signals retain their identity and live getters through config merging. (#11209)
🐛 Bug Fixes
- Proxy Protocols: Accept HTTP(S) proxy schemes with or without a trailing colon, including casing and surrounding whitespace variations. Invalid nonempty strings now fail before connecting with ERR_BAD_OPTION_VALUE; redirect failures retain ERR_FR_REDIRECTION_FAILURE wrapping. Omitted protocols continue to inherit the target protocol. (#11182)
- Request Interceptors: Route synchronous interceptor and dispatch failures through response interceptors. Await recovery promises before dispatch; rejected recovery prevents sending the request, while successful recovery retains the last request config and ignores recovery return values. (#11209)
- Error Compatibility: Allow Axios to load alongside a read-only Error.prototype.toJSON, while preserving supplied own property descriptors and setters. (#11209)
🔧 Maintenance & Chores
- Publishing and Tests: Use npm bundled with Node in the v0 publishing workflow and replace the FormData browser test’s external HTTP request with a Jasmine-Ajax stub. (#11084)
- Repository Cleanup: Add .codex/ to .gitignore. (#11033)
- Release Preparation: Update package and runtime version metadata to 0.34.0. (#11217)
Full Changelog: v0.33.0...v0.34.0
v1.20.0
v1.20.0 — August 19, 2026
This release hardens runtime option handling, adds RFC 9110 status-code aliases, fixes Node.js and XHR reliability issues, and refreshes project tooling and documentation.
⚠️ Breaking Changes & Deprecations
- HTTP Status Naming: Added ContentTooLarge (413) and UnprocessableContent (422), while retaining PayloadTooLarge and UnprocessableEntity as backward-compatible deprecated aliases. (#11082)
🔒 Security Fixes
- Runtime Option Handling: Hardened behavioral configuration reads against shared and foreign prototype pollution and normalized unsafe interceptor replacement objects. This also clarifies Fetch redirect and custom implementation behavior, HTTP/2 DNS and proxy handling, CIDR-based NO_PROXY matching, and malformed data URI rejection; see the PR for documented compatibility effects. (#11141)
🐛 Bug Fixes
- Interceptor Lifecycle: Prevented unbounded handler-array growth by trimming trailing ejected interceptors without changing iteration semantics, and kept interceptor operations safe when the public handlers field is nullish. (#11087, #11118)
- Request Error Preservation: Prevented custom Error.prepareStackTrace implementations that return non-string values from replacing the original request failure with an unrelated TypeError. (#11109)
- XHR Reliability: Navigation-canceled requests now reject with ECONNABORTED instead of resolving with status 0, while successful downloads flush their final progress callback during the live loadend dispatch. (#11094, #11121)
- Node.js Socket Memory: Removed request-context retention from per-socket error listeners, preventing completed response data from being pinned for the lifetime of pooled keep-alive sockets. (#11091)
- Core Methods and HTTP Errors: Prevented structural method-header buckets from leaking into outgoing headers, standardized invalid DNS lookup and httpVersion failures as AxiosError.ERR_BAD_OPTION_VALUE, and corrected the timeoutErrorMessage merge strategy. (#11096)
🔧 Maintenance & Chores
- Dependencies: Updated fast-uri, postcss, js-yaml, mocha, development-tooling groups, and GitHub Actions dependencies. (#11092, #11098, #11099, #11106, #11107, #11122, #11123, #11126, #11127, #11133, #11140, #11143, #11144)
- Documentation: Applied the v1.19.0 documentation updates, added the missing fs import to the README stream example, introduced localized global search, and repaired the interceptor test link. (#11101, #11113, #11097, #11119)
- Sponsorship: Updated sponsorship links and data and added ScrapingBee as a sponsor. (#11124, #11136, #11137)
- CI and Release: Switched ESM smoke tests to locked dependencies and synchronized package and runtime version metadata for v1.20.0. (#11128, #11152)
🌟 New Contributors
We are thrilled to welcome our new contributors. Thank you for helping improve axios:
- @yens1 (#11109)
- @Sasireddy001 (#11113)
- @ari-token-security (#11094)
- @timothyokooboh (#11097)
- @gi9439041-png (#11119)
- @Hashim1999164 (#11082)
- @v-dev-cl (#11091)
- @r0h1tb (#11118)
- @ostapondo (#11121)
Full Changelog (v1.19.0...v1.20.0)
v1.19.0
v1.19.0 - July 22, 2026
This release raises the form-data security floor, adds configuration and type-system capabilities, and fixes NO_PROXY matching, interceptor errors, progress reporting, and serialization edge cases.
🔒 Security Fixes
- Multipart Form Data: Raised the form-data dependency floor to ^4.0.6, preventing fresh installations from resolving versions affected by the CRLF injection vulnerability GHSA-hmw2-7cc7-3qxx (GHSA-hmw2-7cc7-3qxx). (#11028)
🚀 New Features
- Configuration Extensibility: Preserved own-enumerable symbol-keyed fields through mergeConfig and added a generic params type across public TypeScript declarations, responses, errors,
adapters, and serializers. (#11043, #11081) - Header Parameter Parsing: Added the opt-in AxiosHeaders.parseParameters() parser for quote-aware, RFC-style HTTP parameter parsing while preserving legacy parsing behavior. (#11051)
- HTTP Status Codes: Added the missing Cloudflare 520 WebServerReturnsAnUnknownError status and matching ESM/CJS declarations. (#11067)
🐛 Bug Fixes
- Form Data Conversion: Limited formDataToJSON path splitting to dot and bracket notation, preserving literal punctuation in keys, and removed browser-facing Buffer.from usage from toFormData to avoid unnecessary polyfills. (#11006, #11018)
- Proxy Bypass: Canonicalized IPv4 shorthand, octal, and hexadecimal forms during NO_PROXY matching and honored * entries within comma- or space-separated bypass lists. (#11029, #11053)
- Cancellation: Propagated already-aborted input signals immediately when composing abort signals. (#11035)
- Header Handling: Preserved empty first values for duplicate singleton headers and made AxiosHeaders#getSetCookie() consistently return arrays for present values. (#11036, #11037)
- URL Handling: Included normalized, safely redacted offending URLs in malformed-protocol errors and removed repeated trailing slashes when combining base URLs. (#11024, #11038)
- Progress Events: Clamped malformed negative progress values to zero and ensured final Node.js download progress events are delivered before streamed responses close. (#11039, #11040)
- Error and JSON Serialization: Serialized Set values as arrays in JSON-compatible snapshots and synthesized useful AxiosError messages from otherwise-empty AggregateError instances. (#11044, #11059)
- Content-Length Enforcement: Corrected base64 data: URL size estimation so maxContentLength is enforced consistently by the HTTP and Fetch adapters. (#11061)
- Synchronous Interceptors: Prevented requests from being dispatched after synchronous request interceptors fail unless their paired rejection handler resolves successfully. (#11071)
🔧 Maintenance & Chores
- Dependencies: Updated development and test tooling, the docs fixture's Axios version, and GitHub Actions integrations including Checkout, Setup Node, Setup Deno, and Zizmor. (#11031, #11055, #11056, #11058, #11079, #11080, #11088, #11089, #11090)
- Build Outputs: Limited sourcemap generation to published minified bundles, removing broken map references from non-minified builds. (#11054)
- Form Data Internals: Centralized FormData header handling and made the Node.js adapter tolerate getHeaders() returning undefined under the content-only policy. (#11062)
- Developer Experience: Ignored common local AI-tooling directories and fixed a constant-reassignment crash when the development sandbox serves its root path. (#11032, #11073)
- Documentation: Updated sponsor information, clarified that baseURL is not a path-security boundary, scoped provenance claims to attested releases, and corrected the configuration-defaults documentation. (#11041, #11068, #11076, #11078)
- Publishing: Simplified v1 publishing to use the npm version bundled with Node.js 26 and updated package metadata for the 1.19.0 release. (#11083, #11095)
🌟 New Contributors
We are thrilled to welcome our new contributors. Thank you for helping improve Axios:
- @afonsojramos (#11028)
- @MahinAnowar (#11006)
- @yassertawfik4 (#11024)
- @AnandSundar (#11029)
- @lin-hongkuan (#11035)
- @Wali007-lab (#11054)
- @magicdawn (#11043)
- @andrewkernel (#11053)
- @Sagargupta16 (#11059)
- @Rpaudel379 (#11078)
- @kobihikri (#11076)
- @spokodev (#11061)
- @shaedrich (#11081)
- @QodeXcli (#11062)
- @akahoshi1421 (#11067)
- @TheHonoredOne914 (#11071)
- @Ahsan1Murtaza (#11073)
Full Changelog (v1.18.1...v1.19.0)
v1.18.1
v1.18.1 — June 21, 2026
This release focuses on Node HTTP adapter fixes, safer AxiosError serialisation, runtime/type correctness fixes, documentation updates, and dependency maintenance.
🐛 Bug Fixes
- AxiosError Serialisation: Made AxiosError#cause non-enumerable to prevent circular JSON serialisation failures when errors include nested causes. (#10913)
- Node HTTP Adapter: Guarded socket.setKeepAlive for proxy agent streams, accepted path-only URLs when socketPath is configured, deferred environment proxy handling to Node, and explicitly passed maxBodyLength through to follow-redirects. (#10917, #10930, #10942, #10993)
- Runtime and Type Correctness: Fixed several runtime crashes, type definition mismatches, and incorrect error handling paths. (#10959, #11021)
- AxiosURLSearchParams: Switched the encoder callback to an arrow function so
encoder.call(this)receives theAxiosURLSearchParamsinstance correctly. (#11019)
🔧 Maintenance & Chores
-
Documentation: Documented sensitive headers and status transition behaviour, prepared cleaned-up docs, added Deno install instructions, and clarified that request data is request-specific (#11007, #11010, #11023, #11025)
-
Dependencies: Bumped vite, rollup, form-data, js-yaml, and multer across the root project, docs, smoke tests, and module test workspaces. (#11011, #11012, #11013, #11014, #11015, #11016, #11017, #11026)
🌟 New Contributors
We are thrilled to welcome our new contributors. Thank you for helping improve axios:
v1.18.0
v1.18.0 — June 13, 2026
This release hardens redirect and URL handling, improves the validateStatus configuration semantics, and includes updates to documentation, dependencies, and release metadata.
🔒 Security Fixes
-
Redirect Header Safety: Added Node HTTP adapter support for stripping caller-specified sensitive headers on cross-origin redirects, helping prevent custom auth headers such as API keys from leaking to another origin. (#10892)
-
URL And Request Hardening: Rejects malformed
http:andhttps:URLs that omit//withERR_INVALID_URL, while tightening prototype-pollution-safe config reads, stream size limits, FormData depth handling, data URL sizing, and localNO_PROXYmatching. (#11000)
🐛 Bug Fixes
- Status Validation: Added
transitional.validateStatusUndefinedResolvesso applications can opt in to treatingvalidateStatus: undefinedlike the option was omitted, whilevalidateStatus: nullremains the explicit way to accept every status. (#10899)
🔧 Maintenance & Chores
-
Documentation: Published the v1.17.0 release notes, fixed a changelog typo, clarified the package update PR policy, and marked the
proxyrequest config as Node.js-only in the advanced docs. (#10984, #10988, #10992, #10995) -
Dependencies: Bumped
@babel/core,@babel/preset-env,@commitlint/cli,@commitlint/config-conventional,@rollup/plugin-babel,@rollup/plugin-commonjs,@vitest/browser,@vitest/browser-playwright,eslint,lint-staged,rollup,vitest, andactions/checkout. (#10989, #10996, #10997) -
Release Metadata: Prepared the 1.18.0 release by updating package metadata and the runtime
VERSIONvalue. (#11003)
🌟 New Contributors
We are thrilled to welcome our new contributors. Thank you for helping improve axios:
v0.33.0
v0.33.0 — June 13, 2026
This release hardens request config handling and form serialisation, adds Node.js 26 coverage for v0.x, and updates the v0.x release workflow.
🔒 Security Fixes
- Request Config Hardening: Uses own-property reads for nested request options affecting auth, params, proxy, and data handling; adds bounded form serialisation depth checks; normalises nullish Basic Auth credentials; and treats
0.0.0.0as local for proxy bypass. (#11001)
🚀 New Features
- Node.js 26: Adds Node.js 26 to the v0.x CI and release/publish matrices. (#10937)
🔧 Maintenance & Chores
- Release Publishing: Adopts npm staged publishing for v0.x releases and disables npm caching in CI to make installs and publish jobs more deterministic. (#10936, #10943)
- Changelog: Backfills missing v0.x changelog entries for prior releases. (#10842)
- Release Metadata: Bumps package and internal version metadata for v0.33.0. (#11002)
v1.17.0
v1.17.0 — June 1, 2026
This release adds Node HTTP zstd decompression, hardens config and release workflows, and fixes authentication, header, proxy, and type-handling regressions.
🔒 Security Fixes
- Config Hardening: Guarded
socketPath,params, andparamsSerializerreads with own-property checks to prevent inherited prototype values from affecting request behavior, including SSRF-sensitive paths. (#10901, #10922) - Release Publishing: Switched the publish workflow to npm staged publishing for safer, auditable package releases with provenance. (#10926)
🚀 New Features
- HTTP Compression: Added Node HTTP adapter support for zstd response decompression, with
transitional.advertiseZstdAcceptEncodingcontrolling whetherzstdis advertised inAccept-Encoding. (#6792, #10920)
🐛 Bug Fixes
- Authentication Handling: Restored Basic auth on same-origin Node redirects while continuing to strip credentials cross-origin, and aligned the fetch adapter with HTTP adapter behavior for URL-embedded Basic auth. (#10929, #10896)
- Proxy TLS: Preserved user
httpsAgentTLS options when tunneling HTTPS requests through HTTP CONNECT proxies. (#10957) - React Native FormData: Cleared default
Content-Typefor React NativeFormDataso multipart boundaries can be generated correctly. (#10898) - Headers: Silently skipped empty or whitespace-only header names instead of throwing, matching parsed-header behavior and avoiding React Native response crashes. (#10875)
- Request Data Merging: Preserved enumerable symbol keys when cloning plain request data through axios merge logic. (#10812)
- Bundler Compatibility: Converted
resolveConfigfrom an arrow default export to a named function export to avoid webpack and Babel transform interop failures. (#10891) - Types: Corrected
AxiosHeaders.toJSON()return types and updated CommonJSisCanceltypings to narrow toCanceledError<T>. (#10956, #10952) - Build Tooling: Avoided emitting a null
Authorizationheader from the GitHub build helper whenGITHUB_TOKENis unset. (#10931)
🔧 Maintenance & Chores
- HTTP/2 Internals: Extracted
Http2Sessionsinto its own helper module and added direct unit coverage for session pooling, timeout, and cleanup behavior. (#10861) - Package Publishing: Reduced published package size by switching to a
filesallowlist and dropping unneeded unminified bundle source maps. (#10939) - CI and Release Automation: Added bundle-size reporting, moved reports to the job summary, fixed bundle-size comparison coverage, added Node 26 to the matrix, pinned npm for staged publishing, and prepared the 1.17.0 release. (#10907, #10911, #10916, #10927, #10935, #10983)
- Developer Workflow: Added a dev container and iterated on OpenSpec workflow files before removing them from the release branch. (#10925, #10914, #10958)
- Documentation and Policy: Updated disclosure, contributor, collaboration, threat-model, advanced docs, README badges, release notes, moderator configuration, and project metadata. (#10890, #10889, #10921, #10945, #10905, #10933, #10915, #10887, #10955)
- Dependencies: Bumped Babel tooling, Commitlint, ESLint, Rollup, Globals, Vitest, Playwright,
fs-extra,qs, docs dependencies, and GitHub Actions dependencies includingactions/dependency-review-actionandzizmorcore/zizmor-action. (#10871, #10879, #10918, #10919, #10934, #10947, #10954, #10960)
🌟 New Contributors
We are thrilled to welcome our new contributors. Thank you for helping improve axios: