FormData: getAll() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

getAll() は FormData インターフェイスのメソッドで、FormData オブジェクト内から指定されたキーに関連付けられたすべての値を返します。

メモ: このメソッドはウェブワーカーで使用できます。

構文

js
getAll(name)

引数

name

取得したいキーの名前を表す文字列です。

返値

キーが指定した name と一致する値の配列です。そうでない場合は、空のリストです。

例

FormData に、append() を用いて username の値を 2 つ追加したとします。

js
formData.append("username", "Chris");
formData.append("username", "Bob");

以下の getAll() メソッドは、配列で username の値を両方とも返します。

js
formData.getAll("username"); // Returns ["Chris", "Bob"]

仕様書

Specification
XMLHttpRequest Standard
# dom-formdata-getall

ブラウザーの互換性

BCD tables only load in the browser

関連情報