Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

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

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

Примечание: Данный метод также доступен в Web Workers.

Синтаксис

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

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

Параметры

name
Имя поля, которому будет присвоен value.
value
Значение, присваиваемое полю. В варианте с двумя параметрами, это USVString, если нет, то оно будет конвертировано. В варианте с тремя параметрами это может быть Blob, File, или USVString, И снова, если ни один из них не указан в значении то оно будет конвертировано в строку.
filename Необязательный
Имя файла, которое будет отправлено серверу (USVString), когда Blob или File прошел проверку как второй параметр. Стандартное имя файла для Blob объектов это "blob".

Примечание: Если вы укажете Blob в качестве данных для включения в объект FormData, имя файла будет указано для сервера в заголовке "Content-Disposition" и может отличаться от браузера к браузеру.

Пример

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

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

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

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

Specifications

Specification Status Comment
XMLHttpRequest
Определение 'set()' в этой спецификации.
Живой стандарт  

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 50.0 39.0 (39.0) Нет Нет Нет
Available in web workers 50.0 39.0 (39.0) Нет Нет Нет
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support Нет 50.0 (Да) (Да) Нет

Нет

Нет 50.0
Available in web workers Нет 50.0 (Да) (Да) Нет Нет Нет 50.0

See also

Метки документа и участники

Внесли вклад в эту страницу: Gabesdir
Обновлялась последний раз: Gabesdir,