FormData
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
* Some parts of this feature may have varying levels of support.
Примечание: Эта возможность доступна в Web Workers.
XMLHttpRequest 2 добавляет поддержку для нового интерфейса FormData. Объекты FormData позволяют вам легко конструировать наборы пар ключ-значение, представляющие поля формы и их значения, которые в дальнейшем можно отправить с помощью метода send().
FormData использует такой же формат на выходе, как если бы мы отправляли обыкновенную форму с encoding установленным в "multipart/form-data".
Примечание: О деталях использования FormData можно прочитать в статье Использование объекта FormData.
Конструктор
FormData()-
Создаёт объект
FormData.
Методы
FormData.append()-
Добавляет новое значение существующего поля объекта
FormData, либо создаёт его и присваивает значение. FormData.delete()-
Удаляет пару ключ-значение из объекта
FormData. FormData.get()-
Возвращает первое значение ассоциированное с переданным ключом из объекта
FormData. FormData.getAll()-
Возвращает массив всех значений ассоциированных с переданным ключом из объекта
FormData. FormData.has()-
Возвращает булево значение касательно наличия в объекте
FormDataконкретной пары ключ-значение. FormData.set()-
Устанавливает новое значение для существующего ключа объекта
FormData, или добавляет пару ключ-значение, если таковой не обнаружено в объекте. FormData.keys()-
Возвращает
iterator, который позволяет пройтись по всем ключам для каждой пары "ключ-значение" , содержащимся внутри объектаFormData FormData.entries()-
Возвращает
iteratorкоторый позволяет пройтись по всем парам "ключ-значение", содержащимся внутри объектаFormData FormData.values()-
Возвращает
iterator, который позволяет пройтись по всем значениям , содержащимся в объектеFormData
Примечание:
Разница между FormData.set() и FormData.append() заключается в том, что если указанный ключ найден в объекте, FormData.set() перезапишет его новым значением, тогда как FormData.append() добавит новое значение в конец существующего. Смотрите дополнительные материалы с примерами.
Спецификации
| Specification |
|---|
| XMLHttpRequest # interface-formdata |