このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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 ⁨2021年4月⁩.

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

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

構文

js
formData()

引数

なし。

返値

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

例外

DOMException AbortError

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

TypeError

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

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

TBD.

仕様書

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

ブラウザーの互換性

関連情報