Spec-Zone.ru › Web APIs

FormData: метод set()

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Web Workers.

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

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

Синтаксис

set(name, value)
set(name, value, filename)

Параметры

name

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

value

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

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

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

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

Возвращаемое значение

None (undefined).

Примеры

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

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

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

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

formData.set("name", 72);
formData.get("name"); // "72"

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

Спецификация
XMLHttpRequest
# dom-formdata-set

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

Десктопные Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet WebView Android
set 50 18 39 37 11.1 50 39 37 11.3 5.0 50

См. также

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

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FormData/set

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API