Request: formData() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

formData()Request インターフェイスのメソッドで、リクエスト本体を読み込み、 FormData オブジェクトで解決するプロミスとして返します。

構文

js
formData()

引数

なし。

返値

Promise であり、 FormData オブジェクトで解決します。

js
const formData = new FormData();
const fileField = document.querySelector('input[type="file"]');

formData.append("username", "abc123");
formData.append("avatar", fileField.files[0]);

const request = new Request("/myEndpoint", {
  method: "POST",
  body: formData,
});

request.formData().then((data) => {
  // リクエストで送信されたフォームデータに対して何らかの処理を行う
});

仕様書

Specification
Fetch Standard
# ref-for-dom-body-formdata①

ブラウザーの互換性

BCD tables only load in the browser

関連情報