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

関連情報