This page was translated from English by the community.Learn more and join the MDN Web Docs community.
FormData()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..
Примечание: Эта возможность доступна вWeb Workers.
КонструкторFormData() создаёт новые объектFormData, если проще - HTML-форму**.**
Синтаксис
var formData = new FormData(form);Параметры
formНеобязательныйСуществующая HTML-форма, на основе которой будет создана новая. Если ничего не указано, будет создана пустая форма.
Пример
<form name="test"> <input type="text" name="code" value="12345" /> <input type="submit" value="Отправить" /></form>var oldForm = document.forms.test, formData = new FormData(oldForm);console.log(formData.get("code"), formData === oldForm);Методы
Примечание:Подробнее о каждом методе можно прочитать, выбрав его в колонке слева.
Добавление нового текстового поля в форму:
formData.append(name, value, filename);Удаление элемента формы:
formData.delete(name);Получение значения элемента формы:
formData.get(name);Проверка на наличие определённого элемента формы:
formData.has(name);Изменение существующего элемента:
formData.set(name, value, filename);Спецификации
| Specification |
|---|
| XMLHttpRequest # dom-formdata |