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> |
Совместимость с браузерами
Enable JavaScript to view this browser compatibility table.