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()
引数
なし。
返値
例外
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