FormData

FormData インターフェイスは、XMLHttpRequest.send() メソッドを用いることで簡単に送信が可能な、フォームフィールドおよびそれらの値から表現されるキーと値のペアのセットを簡単に構築する手段を提供します。これは、エンコーディングタイプを "multipart/form-data" に設定した場合にフォームが使用するものと同じ形式を使用します。

FormData を実装したオブジェクトは、entries() の代わりに for...of 構造の内部で直接使用できます。for (var p of myFormData)for (var p of myFormData.entries()) と等価です。

メモ: この機能は Web Workers で使用できます。

コンストラクタ

FormData()

新しい FormData オブジェクトを作成します。

メソッド

FormData.append()

FormData オブジェクト内の既存のキーに新たな値を追加するか、キーが存在しない場合はキーを追加します。

FormData.delete() (en-US)

FormData オブジェクトからキーと値のペアを削除します。

FormData.entries()

オブジェクトに含まれているすべてのキーと値のペアを走査できるようにするため、iterator を返します。

FormData.get() (en-US)

FormData オブジェクトから、指定したキーに関連付けられた最初の値を返します。

FormData.getAll() (en-US)

FormData から、指定したキーに関連付けられたすべての値の配列を返します。

FormData.has() (en-US)

FormData オブジェクトがあるキーと値のペアを持っているかを示す真偽値を返します。

FormData.keys()

オブジェクト内に存在するキーと値のペアから、すべてのキーを走査できるようにするための iterator を返します。

FormData.set() (en-US)

FormData オブジェクト内の既存のキーに新たな値を設定するか、キーが存在しない場合はキーと値のペアを追加します。

FormData.values()

オブジェクト内に存在するキーと値のペアから、すべての値を走査できるようにするための iterator を返します。

仕様

Specification
XMLHttpRequest Standard
# interface-formdata

ブラウザ実装状況

BCD tables only load in the browser

関連文書