FormDataにあるフィールドでキーに一致する値を取得

FormDataにあるフィールドでキーに一致する値を取得するには、FormData.getメソッドまたはFormData.getAllメソッドを使用します。
FormData.getメソッドは一致するフィールドの最初の値を取得し、FormData.getAllメソッドは一致するフィールドすべてを取得します。

構文

get

ES5

var result = FormData.get(name);

ES6以降

const result = FormData.get(name);

getAll

ES5

var results = FormData.getAll(name);

ES6以降

const results = FormData.getAll(name);

引数

引数名 説明
第一引数
必須
name string 存在を判定するフィールド名を指定。

戻り値

FormData.getメソッドは一致するフィールドの最初の値を文字列で返し、FormData.getAllメソッドは一致するフィールドすべてを配列で返します。

フィールドが見つからなかった場合は、FormData.getメソッドはnullを、FormData.getAllメソッドは空の配列をそれぞれ返します。

サンプルコード

JavaScript (ES5)

var formData = new FormData();

formData.append('foo', 'abc');
formData.append('foo', '123');

// 一致
alert(formData.get('foo'));
alert(formData.getAll('foo')[1]);

// 不一致
alert(formData.get('bar'));
alert(formData.getAll('bar'));

JavaScript (ES6以降)

const formData = new FormData();

formData.append('foo', 'abc');
formData.append('foo', '123');

// 一致
console.log(formData.get('foo'));
console.log(formData.getAll('foo'));

// 不一致
console.log(formData.get('bar'));
console.log(formData.getAll('bar'));

JavaScript逆引きリファレンス一覧へ戻る