FormData.append()

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

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

Синтаксис

Существует две формы использования данной функции: с двумя и тремя параметрами:

formData.append(name, value);
formData.append(name, value, filename);

Параметры

name

Имя поля, которое будет содержать данные из value.

value

Значение поля. В варианте с двумя параметрами, это является String, если значение не является строкой, то оно будет в неё конвертировано. В варианте с тремя параметрами это может быть Blob, File, или String, И снова, если ни один из них не указан в значении то оно будет конвертировано в строку.

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

Имя файла которое будет отправлено серверу (String), когда Blob или File прошёл проверку как второй параметр. Стандартное имя файла для Blob объектов это "blob".

Возвращает

Пустота.

Пример

Данная строка кода создаёт пустой FormData объект:

var formData = new FormData(); // Currently empty

Вы можете добавлять пару ключ/значение с помощью FormData.append:

formData.append("username", "Chris");
formData.append("userpic", myFileInput.files[0], "chris.jpg");

Также вы можете использовать обозначения массива для первого аргумента:

formData.append("userpic[]", myFileInput1.files[0], "chris1.jpg");
formData.append("userpic[]", myFileInput2.files[0], "chris2.jpg");

Эта техника позволяет упростить мультифайловую загрузку данных потому, что в результате структура данных является более благоприятной для цикла.

Спецификации

Совместимость с браузерами

Смотрите также

• XMLHTTPRequest
• Using XMLHttpRequest
• Using FormData objects
• <Form>