FormData: set() メソッド

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 オブジェクトの既定値は、ファイルのファイル名です。

メモ: FormData オブジェクトに追加するデータとして Blob を指定した場合、"Content-Disposition" ヘッダーでサーバーに報告されるファイル名はブラウザーによって異なることがあります。

なし (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"

Specification
XMLHttpRequest Standard # dom-formdata-set

BCD tables only load in the browser