set() はFormData インターフェイスのメソッドで、FormData オブジェクト内の既存のキーに値を追加したり、存在しないキーと値の組を追加したりします。

set() とappend() の違いは、指定されたキーが既に存在した場合、set() は既存のすべての値を新しい値で上書きすることです。 一方、append() は、既存の値のセットの末尾に新しい値を追加します。

構文

set(name, value)set(name, value, filename)

引数

name

value にあるデータのフィールド名です。

value

フィールドの値です。文字列またはBlob（File などのサブクラスを含む）です。これらの何れでもないものが指定された場合、値は文字列に変換されます。

filename省略可

第 2 引数にBlob またはFile を渡した場合に、サーバーに報告されるファイル名（文字列）です。Blob オブジェクトの既定のファイル名は "blob" です。File オブジェクトの既定値は、ファイルのファイル名です。

返値

なし (undefined)。

例

formData.set("username", "Chris");

値がBlob（またはFile）である場合、その名前をfilename で指定することができます。

formData.set("userpic", myFileInput.files[0], "chris.jpg");

この値が文字列またはBlob でない場合、set() は自動的にそれを文字列に変換します。

formData.set("name", 72);formData.get("name"); // "72"

仕様書

ブラウザーの互換性

関連情報

• FormData オブジェクトの使い方
• <Form>