Response: 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() は Response インターフェイスのメソッドで、 Response のストリームを取得して完全に読み取ります。 FormData オブジェクトで解決されるプロミスを返します。

メモ: これは主にサービスワーカーに関連しています。 ユーザーがフォームを送信し、サービスワーカーがリクエストに介入した場合を考えてみましょう。 例えば、キーと値のマップを取得するために formData() を呼び出し、一部のフィールドを修正した後、フォームをサーバー側に送信 (またはローカルで使用) することができます。

構文

js
formData()

引数

なし。

返値

FormData オブジェクトで解決される Promise。

例外

DOMException AbortError

リクエストが中止された場合。

TypeError

以下のいずれかの原因で発生します。

  • レスポンス本体が妨害またはロックされている場合。
  • 本体コンテンツをデコードする際にエラーが発生した場合（例えば、Content-Encoding ヘッダーが不正な場合など）。
  • 本体の MIME タイプが、レスポンスに含まれる Content-Type ヘッダーから判断できない場合。
  • 本体が FormData オブジェクトとして解釈できない場合。

例

TBD.

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報