Added `axios.formToJSON` method; by DigitalBrainJS · Pull Request #4735 · axios/axios

DigitalBrainJS · 2022-05-21T21:54:41Z

Added formDataToJSON internal helper;
Added axios.formToJSON method that converts form to a deep JSON object;
Added client tests;
Added the ability to handle HTMLFormElement as a request payload;
Added the ability for form/formData objects to be sent as a JSON if the content-type header is explicitly set to application/json;

So now HTML form can be automatically submitted as a JSON object, and there is no need to aggregate the form field values into the object;

<form id="form" action="" method="post" onsubmit="test(event)">
  <input type="text" name="foo" value="1">
  <input type="text" name="deep.prop" value="2">
  <input type="text" name="deep prop spaced" value="3">
  <input type="text" name="baz" value="4">
  <input type="text" name="baz" value="5">

  <select name="user.age">
    <option value="value1">Value 1</option>
    <option value="value2" selected>Value 2</option>
    <option value="value3">Value 3</option>
  </select>

  <input type="submit" value="Save">
</form>

await axios.post('https://httpbin.org/post', document.querySelector('#form'), {
    headers: {'Content-Type': 'application/json'}
});

Form[Data] will be serialized to the following object:

{
  "foo": "1",
  "deep": {
    "prop": {
      "spaced": "3"
    }
  },
  "baz": [
    "4",
    "5"
  ],
  "user": {
    "age": "value2"
  }
}

…ders � Conflicts: � .eslintrc.js � lib/adapters/http.js � lib/adapters/xhr.js

Added `axios.formToJSON` method; Added client tests;

* Fixing proxy beforeRedirect regression (#4708) * Adding Canceler parameters config and request (#4711) Co-authored-by: Jay <[email protected]> * Fixed `toFormData` regression bug (unreleased) with Array-like objects serialization; (#4714) Added `toURLEncodedForm` helper; Added automatic payload serialization to `application/x-www-form-urlencoded` to have parity with `multipart/form-data`; Added test of handling `application/x-www-form-urlencoded` body by express.js; Updated README.md; Added missed param in JSDoc; Fixed hrefs in README.md; Co-authored-by: Jay <[email protected]> * Allow webpack users to overwrite buildins (#4715) Co-authored-by: Jay <[email protected]> * Fixed `AxiosError` status code type; (#4717) Co-authored-by: Jay <[email protected]> * Fixed `AxiosError` stack capturing; (#4718) Co-authored-by: Jay <[email protected]> * allow type definition for axios instance methods (#4224) Co-authored-by: Jay <[email protected]> * add `string[]` to `AxiosRequestHeaders` type (#4322) Co-authored-by: Jay <[email protected]> * Fixing AxiosRequestHeaders typings (#4334) Co-authored-by: Shakirov Kirill <[email protected]> Co-authored-by: Jay <[email protected]> * Added the ability for the `url-encoded-form` serializer to respect the `formSerializer` config; (#4721) Added test for `formSerializer` config in context of `url-encoded-form` serializer; * Updated eslint config; (#4722) Co-authored-by: Jay <[email protected]> * fix: add isCancel type assert (#4293) Co-authored-by: Jay <[email protected]> * Added data URL support for node.js; (#4725) * Added data URL support for node.js; Added missed data URL protocol for the browser environment; Optimized JSON parsing in the default response transformer; Refactored project structure; Added `cause` prop for AxiosError instance that refers to the original error if it was wrapped with `AxiosError.from` method; Added fromDataURI helper; Added test for handling data:url as an `arraybuffer|text|stream`; * Added throwing of 405 HTTP error if the method is not GET; * Fix/4263/maxbodylength defaults (#4731) * test(http): add test case for default body length in follow-redirects * fix(http): provide proper default body length to follow-redirects Co-authored-by: Jay <[email protected]> * Adding types for progress event callbacks (#4675) Co-authored-by: Jay <[email protected]> * Fixed bug #4727 : toFormData Blob issue on node>v17; (#4728) * Fixed bug #4727; Added node 18.x to the CI; Added hotfix for `ERR_OSSL_EVP_UNSUPPORTED` issue with karma running on node >=17.x; Added `cross-env` to allow running build and test scripts on Windows platforms; * Added conditional setting of `--openssl-legacy-provider` option for node versions >=17.x; * Refactored ssl-hotfix & test script; * Fixed and refactored default max body length test due to ECONNRESET failure; * Added test for converting the data uri to a Blob; Fixed bug with parsing mime type for Blob; Co-authored-by: Jay <[email protected]> * URL params serializer; (#4734) * Refactored BuildURL helper to use URLSearchParams serializer; * Updated typings; Added TS test; * Added `axios.formToJSON` method; (#4735) * Draft * Added `formDataToJSON` helper; Added `axios.formToJSON` method; Added client tests; Co-authored-by: Jay <[email protected]> * Bump grunt from 1.5.2 to 1.5.3 (#4743) Bumps [grunt](https://github.com/gruntjs/grunt) from 1.5.2 to 1.5.3. - [Release notes](https://github.com/gruntjs/grunt/releases) - [Changelog](https://github.com/gruntjs/grunt/blob/main/CHANGELOG) - [Commits](gruntjs/grunt@v1.5.2...v1.5.3) --- updated-dependencies: - dependency-name: grunt dependency-type: direct:development ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Updated README.md; (#4742) Updated index.d.ts; Co-authored-by: Jay <[email protected]> * chore: removed Travis CI config file as we have moved to GitHub actions * chore: updated actions to run on new version based branches * Fix/4737/timeout error message for http (#4738) * Fixing timeoutErrorMessage in http calls When timeoutErrorMessage was set this did not change anything in the error message, with this change the error message will be the configured message * Testing timeoutErrorMessage in http calls When timeoutErrorMessage was set this did not change anything in the error message, with this change the error message will be the configured message Co-authored-by: Jay <[email protected]> * Fixing content-type header repeated (#4745) Co-authored-by: Jay <[email protected]> Co-authored-by: Maxime Bargiel <[email protected]> Co-authored-by: 毛呆 <[email protected]> Co-authored-by: Dmitriy Mozgovoy <[email protected]> Co-authored-by: Tom Ceuppens <[email protected]> Co-authored-by: Jelle Schutter <[email protected]> Co-authored-by: Rraji Abdelbari <[email protected]> Co-authored-by: Kirill Shakirov <[email protected]> Co-authored-by: Shakirov Kirill <[email protected]> Co-authored-by: chenjigeng <[email protected]> Co-authored-by: Dimitris Halatsis <[email protected]> Co-authored-by: Johann Cooper <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Victor Augusto <[email protected]> Co-authored-by: João Gabriel Quaresma <[email protected]>

jimmywarting · 2022-12-19T16:38:42Z

Have never like this kind of solution that makes the result sometimes be a object pair or an array.
it's a disaster waiting to happen. someone on a backend expects an array and always do body.baz.forEach(...) then someone could handcrafted payload that only include one baz then it would break b/c it's now an object instead. it's just bad practices.

i would rather do:

[...formData] to get a [key, value][] or:
Object.fromEntries(fd) to always get out a object.

eudinnou · 2023-11-16T09:09:45Z

this looks like a(another) breaking change 😞 We are upgrading axios from 0.x to the latest version and we had configured by default the content-type header to 'application/json' and now the post formData is transformed to json. The xhr adapter has a condition to delete the content-type header if the request data is formData, but it doesn't have a chance anymore because of this default transformRequest

and this logic is a bit twisted:

    if (isFormData) {
      if (!hasJSONContentType) {
        return data;
      }
      return hasJSONContentType ? JSON.stringify(formDataToJSON(data)) : data;
    }

willpoorman · 2024-02-05T19:41:56Z

this looks like a(another) breaking change 😞 We are upgrading axios from 0.x to the latest version and we had configured by default the content-type header to 'application/json' and now the post formData is transformed to json. The xhr adapter has a condition to delete the content-type header if the request data is formData, but it doesn't have a chance anymore because of this default transformRequest

and this logic is a bit twisted:
    if (isFormData) {
      if (!hasJSONContentType) {
        return data;
      }
      return hasJSONContentType ? JSON.stringify(formDataToJSON(data)) : data;
    }

I've noticed the same thing after upgrading in a similar situation. We had default Content-Type set to application/json but occasionally had usage where a multi-part form data was provided. It would replace the default Content Type with the multi-part form one when that data was provided. But now, with this change in place, it automatically converts the form data to json rather than automatically switches the content-type from json to multipart form

DigitalBrainJS · 2024-02-05T21:02:06Z

@willpoorman Well, the major version release assumes that there are breaking changes. It seems quite logical that if you set an explicit JSON content-type header, you are expecting JSON and not something else.

* Draft * Added `formDataToJSON` helper; Added `axios.formToJSON` method; Added client tests; Co-authored-by: Jay <[email protected]>

DigitalBrainJS and others added 4 commits May 16, 2022 15:05

Draft

a238917

Merge branch 'master' of https://github.com/axios/axios into feat/hea…

ec006de

…ders � Conflicts: � .eslintrc.js � lib/adapters/http.js � lib/adapters/xhr.js

Added formDataToJSON helper;

596bcee

Added `axios.formToJSON` method; Added client tests;

Merge branch 'master' into feat/formdata-to-json

ce243d6

jasonsaayman merged commit c008e57 into axios:master May 25, 2022

redpeacock78 mentioned this pull request Oct 5, 2022

Update axios to the latest version redpeacock78/line-sticker-downloder#30

Merged

girishjaju18 mentioned this pull request Nov 22, 2022

[Snyk] Upgrade axios from 0.27.2 to 1.1.3 ZscalerCWP/Zscaler-IaC-Action#45

Closed

DigitalBrainJS mentioned this pull request Jan 31, 2024

[Release] v0.28.0 #6211

Merged

ayoshebby mentioned this pull request Apr 18, 2024

AUT-2393: Axios upgrade from 0.25.0 to 0.1.6.8 govuk-one-login/authentication-frontend#1555

Merged

katnova mentioned this pull request May 19, 2024

[Snyk] Upgrade axios from 0.21.3 to 0.28.1 katnova/2FAuth#731

Open

rc042 mentioned this pull request May 19, 2024

[Snyk] Upgrade axios from 0.19.1 to 0.28.1 rc042/centreon#193

Open

nejidevelops mentioned this pull request May 19, 2024

[Snyk] Upgrade axios from 0.18.1 to 0.28.1 nejidevelops/Serveless-Application#19

Open

katnova mentioned this pull request May 19, 2024

[Snyk] Upgrade axios from 0.21.3 to 0.28.1 katnova/2FAuth#736

Open

BuloZB mentioned this pull request May 20, 2024

[Snyk] Upgrade axios from 0.13.1 to 0.28.1 BuloZB/pokemongo-webspoof#2

Open

ariel-enso mentioned this pull request May 20, 2024

[Snyk-dev] Upgrade axios from 0.21.4 to 0.28.1 ariel-enso/brokencrystals#1

Open

nejidevelops mentioned this pull request May 20, 2024

[Snyk] Upgrade axios from 0.18.1 to 0.28.1 nejidevelops/Serveless-Application#22

Open

katnova mentioned this pull request May 21, 2024

[Snyk] Upgrade axios from 0.21.3 to 0.28.1 katnova/2FAuth#741

Open

olokotoh mentioned this pull request May 21, 2024

[Snyk] Upgrade axios from 0.28.0 to 0.28.1 olokotoh/semaphore#5

Open

cs-sagarmalve mentioned this pull request Jun 1, 2024

[Snyk] Upgrade axios from 0.24.0 to 1.6.8 contentstack/marketplace-ecomm-boilerplate-app#61

Closed

smashyalts mentioned this pull request Jun 2, 2024

[Snyk] Upgrade axios from 0.28.0 to 0.28.1 smashyalts/heliactyl#5

Open

Hanae1963 mentioned this pull request Jun 8, 2024

[Snyk] Upgrade axios from 0.21.1 to 0.28.1 Hanae1963/remix-plugin#3

Open

aravindvnair99 mentioned this pull request Jun 10, 2024

[Snyk] Upgrade axios from 0.25.0 to 1.7.0 aravindvnair99/Spot-the-Hole#547

Closed

q1blue mentioned this pull request Jun 17, 2024

[Snyk] Upgrade axios from 0.27.2 to 1.7.2 https-quantumblockchainai-atlassian-net/ossinsight#748

Open

gardnern mentioned this pull request Jun 18, 2024

[Snyk] Upgrade axios from 0.18.0 to 1.7.2 gardnern/liri-node-app#10

Open

aravindvnair99 mentioned this pull request Jul 2, 2024

[Snyk] Upgrade axios from 0.25.0 to 1.7.2 aravindvnair99/Spot-the-Hole#560

Closed

q1blue mentioned this pull request Jul 3, 2024

[Snyk] Upgrade axios from 0.27.2 to 1.7.2 https-quantumblockchainai-atlassian-net/ossinsight#761

Open

Stanislav1975 mentioned this pull request Aug 9, 2024

[Snyk] Upgrade axios from 0.27.2 to 1.7.2 Stanislav1975/win11React#5

Open

dinnysingh mentioned this pull request Aug 10, 2024

[Snyk] Upgrade axios from 0.21.4 to 0.28.1 UMENIT-SOLUTIONS-LLP/openSwiftstay_backend_nodejs#3

Open

natelandon mentioned this pull request Sep 15, 2024

[Snyk] Upgrade: react, react-dom, , axios, react-bootstrap natelandon/mern-exercise-tracker#130

Open

hbenali mentioned this pull request Sep 21, 2024

[Snyk] Upgrade axios from 0.28.0 to 0.28.1 exoplatform/ecms#2396

Merged

fiftin mentioned this pull request Sep 28, 2024

[Snyk] Upgrade axios from 0.28.0 to 0.28.1 semaphoreui/semaphore#2374

Closed

Zionsammy mentioned this pull request Oct 27, 2024

[Snyk] Upgrade axios from 0.21.1 to 0.28.1 Zionsammy/remix-plugin#3

Open

Tiphannie pushed a commit to Tiphannie/axios that referenced this pull request Jul 4, 2025

Added axios.formToJSON method; (axios#4735)

44202ee

* Draft * Added `formDataToJSON` helper; Added `axios.formToJSON` method; Added client tests; Co-authored-by: Jay <[email protected]>

Tiphannie pushed a commit to Tiphannie/axios that referenced this pull request Jul 4, 2025

Added axios.formToJSON method; (axios#4735)

adef1ed

* Draft * Added `formDataToJSON` helper; Added `axios.formToJSON` method; Added client tests; Co-authored-by: Jay <[email protected]>

Tiphannie pushed a commit to Tiphannie/axios that referenced this pull request Jul 4, 2025

Added axios.formToJSON method; (axios#4735)

33af506

* Draft * Added `formDataToJSON` helper; Added `axios.formToJSON` method; Added client tests; Co-authored-by: Jay <[email protected]>

Tiphannie pushed a commit to Tiphannie/axios that referenced this pull request Jul 4, 2025

Added axios.formToJSON method; (axios#4735)

b46cad7

* Draft * Added `formDataToJSON` helper; Added `axios.formToJSON` method; Added client tests; Co-authored-by: Jay <[email protected]>

Tiphannie pushed a commit to Tiphannie/axios that referenced this pull request Jul 4, 2025

Added axios.formToJSON method; (axios#4735)

caa5756

* Draft * Added `formDataToJSON` helper; Added `axios.formToJSON` method; Added client tests; Co-authored-by: Jay <[email protected]>

This was referenced Oct 27, 2025

Bump axios from 0.16.2 to 1.13.0 Pouria-FOSSA/dependabot-metadata-test#74

Closed

Bump axios from 0.16.2 to 1.13.1 Pouria-FOSSA/dependabot-metadata-test#75

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Added `axios.formToJSON` method;#4735

Added `axios.formToJSON` method;#4735
jasonsaayman merged 4 commits intoaxios:masterfrom
DigitalBrainJS:feat/formdata-to-json

DigitalBrainJS commented May 21, 2022 •

edited

Loading

Uh oh!

jimmywarting commented Dec 19, 2022

Uh oh!

eudinnou commented Nov 16, 2023

Uh oh!

willpoorman commented Feb 5, 2024

Uh oh!

DigitalBrainJS commented Feb 5, 2024

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

DigitalBrainJS commented May 21, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jimmywarting commented Dec 19, 2022

Uh oh!

eudinnou commented Nov 16, 2023

Uh oh!

willpoorman commented Feb 5, 2024

Uh oh!

DigitalBrainJS commented Feb 5, 2024

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

DigitalBrainJS commented May 21, 2022 •

edited

Loading