This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

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-форму**.**

Синтаксис

js
var formData = new FormData(form);

Параметры

form Необязательный

Существующая HTML-форма, на основе которой будет создана новая. Если ничего не указано, будет создана пустая форма.

Пример

html
<form name="test">
  <input type="text" name="code" value="12345" />
  <input type="submit" value="Отправить" />
</form>
js
var oldForm = document.forms.test,
  formData = new FormData(oldForm);
console.log(formData.get("code"), formData === oldForm);

Методы

Примечание: Подробнее о каждом методе можно прочитать, выбрав его в колонке слева.

Добавление нового текстового поля в форму:

js
formData.append(name, value, filename);

Удаление элемента формы:

js
formData.delete(name);

Получение значения элемента формы:

js
formData.get(name);

Проверка на наличие определённого элемента формы:

js
formData.has(name);

Изменение существующего элемента:

js
formData.set(name, value, filename);

Спецификации

Specification
XMLHttpRequest
# dom-formdata

Совместимость с браузерами