Visitar URL original
docs: apply v1.19.0 release updates by jasonsaayman · Pull Request #11101 · axios/axios · GitHub
Skip to content

docs: apply v1.19.0 release updates - #11101

Merged
jasonsaayman merged 9 commits into
v1.xfrom
chore/post-release-process
Jul 27, 2026
Merged

jasonsaayman merged 9 commits into
v1.xfrom
chore/post-release-process

Conversation

@jasonsaayman

@jasonsaayman jasonsaayman commented Jul 26, 2026 •

Copy link
Copy Markdown
Member

Summary

Completes the v1.19.0 post-release documentation process by publishing the release notes, clearing the pre-release changelog, and applying all deferred documentation updates across the README and documentation site.

Linked issue

N/A

Changes

  • Add the v1.19.0 release notes to CHANGELOG.md and clear PRE_RELEASE_CHANGELOG.md.
  • Document typed request params, synchronous interceptor errors, AxiosHeaders.parseParameters(), malformed HTTP(S) URL rejection, symbol-keyed config, and FormData key parsing.
  • Synchronize the English, Spanish, French, and Chinese documentation.
  • Correct HTML form examples so only dot and bracket notation create nested paths.
  • Mark all entries in PRE_RELEASE_DOCS.md as applied.

Checklist

  • Tests added or updated (N/A: documentation and release metadata only; the docs build, TypeScript examples, and 87 focused unit tests pass)
  • Docs/types updated if public API changed (index.d.ts and index.d.cts were updated by the original feature changes; this PR synchronizes the documentation)
  • No breaking changes (this PR only updates documentation and release metadata; the previously shipped URL behavior change is called out in the upgrade guide)

Summary by cubic

Publishes v1.19.0 release notes and syncs post‑release docs across README and all locales. Finalizes TypeScript generics, URL validation, interceptor error flow, and header parsing docs.

Description

  • Summary of changes
    • Add v1.19.0 notes to CHANGELOG.md; remove stray control character; clear PRE_RELEASE_CHANGELOG.md; mark PRE_RELEASE_DOCS.md items as applied.
    • Update README.md and docs (en/es/fr/zh) to cover:
      • Callable axios<T, R, D, P>(url | config, config?); preserve D and P on response.config.
      • Typed params P across public types (AxiosRequestConfig, AxiosResponse, AxiosPromise, errors, adapters, serializers).
      • AxiosHeaders.parseParameters() and headers.get(name, AxiosHeaders.parseParameters) overload; align get signature/returns across locales.
      • Synchronous request interceptor error handling and when rejections block dispatch.
      • Rejection of malformed http:/https: URLs missing // in both url and baseURL (ERR_INVALID_URL); upgrade‑guide entries.
      • formToJSON() and HTML form parsing: only dot/bracket notation creates paths.
    • Changelog notes form-data@^4.0.6 floor for CRLF advisory.
  • Reasoning
    • Finalize and publish v1.19.0 documentation to match shipped behavior and TypeScript APIs.
  • Additional context
    • Docs-only; no runtime changes.

Docs

Update /docs/ and README.md, then redeploy the docs site to publish the v1.19.0 updates.

Testing

No tests added or modified. Build/preview the docs and run TypeScript checks on code samples.

Semantic version impact

None. Documentation-only changes.

Written for commit 8489409. Summary will update on new commits.

Review in cubic

@jasonsaayman jasonsaayman self-assigned this Jul 26, 2026
Copilot AI review requested due to automatic review settings July 26, 2026 15:28
@jasonsaayman jasonsaayman added the commit::chore The PR is related to a chore label Jul 26, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Completes the v1.19.0 post-release documentation rollout by publishing finalized release notes, clearing pre-release tracking, and applying deferred README/docs updates (including translated docs) for changes shipped in 1.19.0.

Changes:

  • Publish v1.19.0 release notes in CHANGELOG.md and clear PRE_RELEASE_CHANGELOG.md.
  • Update README + docs site content for typed params, synchronous interceptor error behavior, malformed URL rejection, AxiosHeaders.parseParameters, symbol-keyed config, and FormData key parsing.
  • Mark deferred documentation items as applied in PRE_RELEASE_DOCS.md and synchronize translations (EN/ES/FR/ZH).

Reviewed changes

Copilot reviewed 60 out of 60 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
README.md Adds/updates user-facing docs for interceptor error handling, malformed URL rejection, FormData key parsing, headers parameter parsing, and TS generics.
PRE_RELEASE_DOCS.md Marks deferred documentation items as applied with updated notes.
PRE_RELEASE_CHANGELOG.md Clears pre-release entries after release publication.
CHANGELOG.md Adds v1.19.0 release notes.
docs/pages/getting-started/upgrade-guide.md Adds v1.19.0 upgrade notes (EN).
docs/pages/advanced/type-script.md Documents new TS request generics + symbol-keyed config (EN).
docs/pages/advanced/response-schema.md Updates TS response schema docs for new generics (EN).
docs/pages/advanced/request-method-aliases.md Updates request alias type signatures/generic ordering (EN).
docs/pages/advanced/request-config.md Documents malformed URL rejection + typed params + symbol-keyed config (EN).
docs/pages/advanced/promises.md Documents AxiosPromise<T, D, P> behavior (EN).
docs/pages/advanced/multipart-form-data-format.md Documents FormData-to-JSON key parsing semantics (EN).
docs/pages/advanced/interceptors.md Documents synchronous interceptor error behavior (EN).
docs/pages/advanced/html-form-processing.md Corrects HTML form examples for literal key parsing (EN).
docs/pages/advanced/header-methods.md Documents AxiosHeaders.parseParameters usage (EN).
docs/pages/advanced/error-handling.md Documents malformed HTTP(S) URL rejection + safe redaction (EN).
docs/pages/advanced/cancellation.md Documents typed isCancel<T, D, P>() narrowing (EN).
docs/pages/advanced/api-reference.md Updates API reference for new TS generics + parsing notes (EN).
docs/pages/advanced/adapters.md Documents adapter typing preserving request generics (EN).
docs/zh/pages/getting-started/upgrade-guide.md Adds v1.19.0 upgrade notes (ZH).
docs/zh/pages/advanced/type-script.md Documents new TS request generics + symbol-keyed config (ZH).
docs/zh/pages/advanced/response-schema.md Updates TS response schema docs for new generics (ZH).
docs/zh/pages/advanced/request-method-aliases.md Updates request alias type signatures/generic ordering (ZH).
docs/zh/pages/advanced/request-config.md Documents malformed URL rejection + typed params + symbol-keyed config (ZH).
docs/zh/pages/advanced/promises.md Documents AxiosPromise<T, D, P> behavior (ZH).
docs/zh/pages/advanced/multipart-form-data-format.md Documents FormData-to-JSON key parsing semantics (ZH).
docs/zh/pages/advanced/interceptors.md Documents synchronous interceptor error behavior (ZH).
docs/zh/pages/advanced/html-form-processing.md Corrects HTML form examples for literal key parsing (ZH).
docs/zh/pages/advanced/header-methods.md Documents AxiosHeaders.parseParameters usage (ZH).
docs/zh/pages/advanced/error-handling.md Documents malformed HTTP(S) URL rejection + safe redaction (ZH).
docs/zh/pages/advanced/cancellation.md Documents typed isCancel<T, D, P>() narrowing (ZH).
docs/zh/pages/advanced/api-reference.md Updates API reference for new TS generics + parsing notes (ZH).
docs/zh/pages/advanced/adapters.md Documents adapter typing preserving request generics (ZH).
docs/fr/pages/getting-started/upgrade-guide.md Adds v1.19.0 upgrade notes (FR).
docs/fr/pages/advanced/type-script.md Documents new TS request generics + symbol-keyed config (FR).
docs/fr/pages/advanced/response-schema.md Updates TS response schema docs for new generics (FR).
docs/fr/pages/advanced/request-method-aliases.md Updates request alias type signatures/generic ordering (FR).
docs/fr/pages/advanced/request-config.md Documents malformed URL rejection + typed params + symbol-keyed config (FR).
docs/fr/pages/advanced/promises.md Documents AxiosPromise<T, D, P> behavior (FR).
docs/fr/pages/advanced/multipart-form-data-format.md Documents FormData-to-JSON key parsing semantics (FR).
docs/fr/pages/advanced/interceptors.md Documents synchronous interceptor error behavior (FR).
docs/fr/pages/advanced/html-form-processing.md Corrects HTML form examples for literal key parsing (FR).
docs/fr/pages/advanced/header-methods.md Documents AxiosHeaders.parseParameters usage (FR).
docs/fr/pages/advanced/error-handling.md Documents malformed HTTP(S) URL rejection + safe redaction (FR).
docs/fr/pages/advanced/cancellation.md Documents typed isCancel<T, D, P>() narrowing (FR).
docs/fr/pages/advanced/api-reference.md Updates API reference for new TS generics + parsing notes (FR).
docs/fr/pages/advanced/adapters.md Documents adapter typing preserving request generics (FR).
docs/es/pages/getting-started/upgrade-guide.md Adds v1.19.0 upgrade notes (ES).
docs/es/pages/advanced/type-script.md Documents new TS request generics + symbol-keyed config (ES).
docs/es/pages/advanced/response-schema.md Updates TS response schema docs for new generics (ES).
docs/es/pages/advanced/request-method-aliases.md Updates request alias type signatures/generic ordering (ES).
docs/es/pages/advanced/request-config.md Documents malformed URL rejection + typed params + symbol-keyed config (ES).
docs/es/pages/advanced/promises.md Documents AxiosPromise<T, D, P> behavior (ES).
docs/es/pages/advanced/multipart-form-data-format.md Documents FormData-to-JSON key parsing semantics (ES).
docs/es/pages/advanced/interceptors.md Documents synchronous interceptor error behavior (ES).
docs/es/pages/advanced/html-form-processing.md Corrects HTML form examples for literal key parsing (ES).
docs/es/pages/advanced/header-methods.md Documents AxiosHeaders.parseParameters usage (ES).
docs/es/pages/advanced/error-handling.md Documents malformed HTTP(S) URL rejection + safe redaction (ES).
docs/es/pages/advanced/cancellation.md Documents typed isCancel<T, D, P>() narrowing (ES).
docs/es/pages/advanced/api-reference.md Updates API reference for new TS generics + parsing notes (ES).
docs/es/pages/advanced/adapters.md Documents adapter typing preserving request generics (ES).

Comment thread CHANGELOG.md Outdated
Comment thread CHANGELOG.md Outdated
@greptile-apps

greptile-apps Bot commented Jul 26, 2026 •

Copy link
Copy Markdown

Greptile Summary

Publishes the v1.19.0 release documentation and synchronizes the documented APIs and behavior across supported locales.

  • Adds v1.19.0 release notes and clears pre-release tracking content.
  • Documents typed request params, synchronous interceptor errors, header parameter parsing, malformed URL rejection, symbol-keyed config, and FormData key parsing.
  • Updates the English, Spanish, French, and Chinese documentation consistently.

Confidence Score: 5/5

The documentation-only pull request appears safe to merge.

No blocking failures remain.

T-Rex T-Rex Logs

What T-Rex did

  • The current build completed successfully with exit code 0 in 10.57 seconds.
  • The English documentation page was loaded from the English URL and showed the heading 'Typing request data and query params.'.
  • The localized Chinese documentation page was loaded from the localized URL and showed the heading '为请求数据和查询参数添加类型.'.
  • A TypeScript sample check was executed and exited with code 0 using strict Node 16 module resolution.
  • A baseline comparison was performed against commit 5097193, and both baseline and current captures used the real built VitePress site and its repository styles.

View all artifacts

T-Rex Ran code and verified through T-Rex

Important Files Changed

Filename Overview
CHANGELOG.md Adds the v1.19.0 release notes, including security, feature, bug-fix, and maintenance entries.
README.md Documents the newly released TypeScript APIs and runtime behaviors with updated examples.
PRE_RELEASE_CHANGELOG.md Clears entries that were incorporated into the v1.19.0 changelog.
PRE_RELEASE_DOCS.md Marks the deferred v1.19.0 documentation work as applied.
docs/pages/advanced/interceptors.md Explains synchronous request-interceptor recovery and request-blocking behavior.
docs/pages/advanced/type-script.md Documents request-data and query-parameter generic propagation through the public TypeScript API.
docs/pages/advanced/error-handling.md Documents malformed HTTP(S) URL rejection and error-message redaction.
docs/pages/advanced/header-methods.md Documents the opt-in AxiosHeaders parameter parser and its overload.
docs/pages/advanced/html-form-processing.md Corrects form conversion examples to reflect dot-and-bracket path parsing.
docs/pages/getting-started/upgrade-guide.md Adds v1.19.0 migration guidance for malformed URLs and synchronous interceptors.

Reviews (9): Last reviewed commit: "Update CHANGELOG.md" | Re-trigger Greptile

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread docs/zh/pages/advanced/request-method-aliases.md Outdated
Comment thread docs/pages/advanced/request-method-aliases.md Outdated
Comment thread docs/es/pages/advanced/header-methods.md
Comment thread docs/es/pages/advanced/request-method-aliases.md Outdated
Comment thread CHANGELOG.md Outdated
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 26, 2026 15:49

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 60 out of 60 changed files in this pull request and generated 5 comments.

Comment thread README.md Outdated
Comment thread docs/pages/advanced/request-method-aliases.md Outdated
Comment thread docs/zh/pages/advanced/request-method-aliases.md Outdated
Comment thread docs/fr/pages/advanced/request-method-aliases.md Outdated
Comment thread docs/es/pages/advanced/request-method-aliases.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 27, 2026 15:03

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 60 out of 60 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (4)

docs/pages/advanced/request-method-aliases.md:129

  • The getUri signature references type parameters D and P that are not declared in this snippet, making the TypeScript example invalid. Either declare the generics on getUri or (to match the published typings) use the non-generic AxiosRequestConfig here. 🏄
    docs/zh/pages/advanced/request-method-aliases.md:113
  • The getUri signature references type parameters D and P that are not declared in this snippet, making the TypeScript example invalid. Either declare the generics on getUri or (to match the published typings) use the non-generic AxiosRequestConfig here. 🏄
    docs/fr/pages/advanced/request-method-aliases.md:113
  • The getUri signature references type parameters D and P that are not declared in this snippet, making the TypeScript example invalid. Either declare the generics on getUri or (to match the published typings) use the non-generic AxiosRequestConfig here. 🏄
axios.getUri(config?: AxiosRequestConfig): string;

docs/es/pages/advanced/request-method-aliases.md:113

  • The getUri signature references type parameters D and P that are not declared in this snippet, making the TypeScript example invalid. Either declare the generics on getUri or (to match the published typings) use the non-generic AxiosRequestConfig here. 🏄
axios.getUri(config?: AxiosRequestConfig): string;

Comment thread CHANGELOG.md Outdated
Copilot AI review requested due to automatic review settings July 27, 2026 15:09

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 60 out of 60 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

CHANGELOG.md:24

  • The URL Handling bullet includes a stray carriage-return/control character at the end of the line (visible as an extra character after the closing parenthesis), which can cause noisy diffs and tooling issues. Please remove it so the line is clean ASCII text. 🏄
- URL Handling: Included normalized, safely redacted offending URLs in malformed-protocol errors and removed repeated trailing slashes when combining base URLs. (#11000, #11008, #11038)

Copilot AI review requested due to automatic review settings July 27, 2026 15:13

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 60 out of 60 changed files in this pull request and generated 1 comment.

Comment thread CHANGELOG.md Outdated

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 14 files (changes from recent commits).

Tip: Review your code locally with the cubic CLI to iterate faster.

Re-trigger cubic

Comment thread CHANGELOG.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 27, 2026 15:24
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 60 out of 60 changed files in this pull request and generated 4 comments.

Comment on lines +12 to +15
axios<T, R, D, P>(
url: string | AxiosRequestConfig<D, P>,
config?: AxiosRequestConfig<D, P>
): Promise<R>;
Comment on lines +12 to +15
axios<T, R, D, P>(
url: string | AxiosRequestConfig<D, P>,
config?: AxiosRequestConfig<D, P>
): Promise<R>;
Comment on lines +12 to +15
axios<T, R, D, P>(
url: string | AxiosRequestConfig<D, P>,
config?: AxiosRequestConfig<D, P>
): Promise<R>;
Comment on lines +12 to +15
axios<T, R, D, P>(
url: string | AxiosRequestConfig<D, P>,
config?: AxiosRequestConfig<D, P>
): Promise<R>;
@jasonsaayman
jasonsaayman merged commit 800504c into v1.x Jul 27, 2026
29 checks passed
@jasonsaayman
jasonsaayman deleted the chore/post-release-process branch August 19, 2026 16:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

commit::chore The PR is related to a chore

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants