FormData: метод append()

Метод append() интерфейса FormData добавляет новое значение к существующему ключу внутри объекта FormData, или добавляет ключ, если он еще не существует.

Разница между set() и append() заключается в том, что если указанный ключ уже существует, set() перезапишет все существующие значения новым, а append() добавит новое значение в конец существующего набора значений.

name

Имя поля, данные которого содержатся в value.

value

Значение поля. Это может быть строка или Blob (включая подклассы, такие как File). Если ни один из них не указан, значение преобразуется в строку.

filename Необязательно

Имя файла, передаваемое серверу (строка), когда в качестве второго параметра передаётся Blob или File. Значение по умолчанию для Blob объектов — "blob". Значение по умолчанию для File объектов — имя файла.

Ничего (undefined).

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

Когда значение является Blob (или File), вы можете указать его имя с помощью параметра filename:

formData.append("user-pic", myFileInput.files[0], "chris.jpg");

Как и с обычными данными формы, вы можете добавить несколько значений с одинаковым именем:

formData.append("user-pic", myFileInput.files[0], "chris1.jpg");
formData.append("user-pic", myFileInput.files[1], "chris2.jpg");

Если значение не является строкой или Blob, append() автоматически преобразует его в строку:

formData.append("name", true);
formData.append("name", 72);
formData.getAll("name"); // ["true", "72"]

• Использование объектов FormData
• <form>