FormData
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 Standard # interface-formdata |
Совместимость
BCD tables only load in the browser