FormData: get() メソッド

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.

get() は FormData インターフェイスのメソッドで、FormData オブジェクトの中から、指定されたキーに関連付けられた最初の値を返します。複数の値を期待し、すべてが欲しい場合は、代わりに getAll() メソッドを使用してください。

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

構文

js
get(name)

引数

name

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

返値

指定された name に一致するキーの値です。見つからなければ null です。

例

2 つの username 値を FormData に、append() を使って追加した場合、

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

次の get() メソッドは最初の username 値のみを返します。

js
formData.get("username"); // "Chris" を返す

仕様書

Specification
XMLHttpRequest Standard
# dom-formdata-get

ブラウザーの互換性

BCD tables only load in the browser

関連情報