URL-エンコードボディ

デフォルトでは、Axios は JavaScript オブジェクトを JSON にシリアライズします。代わりに application/x-www-form-urlencoded 形式でデータを送信するには、次のいずれかのオプションを使用します。

ブラウザ

ブラウザでは、以下のように URLSearchParams の API を使用できます。

const params = new URLSearchParams();
params.append('param1', 'value1');
params.append('param2', 'value2');
axios.post('/foo', params);

なお、URLSearchParams はすべてのブラウザでサポートされているわけではありませんが (参照: caniuse.com)、polyfill が利用できます (必ずグローバル環境をポリフィルしてください)。

または、以下のように qs ライブラリを使用してデータをエンコードすることもできます。

const qs = require('qs');
axios.post('/foo', qs.stringify({ 'bar': 123 }));

あるいは別の方法 (ES6) でも。

import qs from 'qs';
const data = { 'bar': 123 };
const options = {
  method: 'POST',
  headers: { 'content-type': 'application/x-www-form-urlencoded' },
  data: qs.stringify(data),
  url,
};
axios(options);

Node.js

クエリ文字列

Node.js では、以下のように querystring モジュールを使用することができます。

const querystring = require('querystring');
axios.post('http://something.com/', querystring.stringify({ foo: 'bar' }));

または、'url module' に定義された 'URLSearchParams' を以下のように使用します。

const url = require('url');
const params = new url.URLSearchParams({ foo: 'bar' });
axios.post('http://something.com/', params.toString());

また、qs ライブラリを使用することもできます。

注

ネストしたオブジェクトを文字列化する必要がある場合は、qs ライブラリが適しています。なぜなら、 querystring メソッドには、その使用例に対して既知の問題があるからです (https://github.com/nodejs/node-v0.x-archive/issues/1665)。

フォームデータ

Node.js では、以下のように form-data ライブラリを使用することができます。

const FormData = require('form-data');
 
const form = new FormData();
form.append('my_field', 'my value');
form.append('my_buffer', new Buffer(10));
form.append('my_file', fs.createReadStream('/foo/bar.jpg'));

axios.post('https://example.com', form, { headers: form.getHeaders() })

または、以下のようにインターセプターを使用します。

axios.interceptors.request.use(config => {
  if (config.data instanceof FormData) {
    Object.assign(config.headers, config.data.getHeaders());
  }
  return config;
});