FormData.set()

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

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

Синтаксис

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

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

Параметры

name

Имя поля, которому будет присвоен value.

value

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

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

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

Пример

Следующий код создаёт пустой FormData объект:

var formData = new FormData(); // Сейчас пустой

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

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

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

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

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

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