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
# ref-for-dom-body-formdata①

ブラウザーの互換性

BCD tables only load in the browser

関連情報