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 |
См. также
© 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