FormData

Базовая Широко доступная *

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

* Некоторые части этой функции могут иметь разный уровень поддержки.

Примечание: Эта функция доступна в Потоках выполнения.

Интерфейс FormData предоставляет способ создания набора пар «ключ-значение», представляющих поля формы и их значения, которые можно отправить с помощью методов fetch(), XMLHttpRequest.send() или navigator.sendBeacon(). Он использует тот же формат, что и форма, если тип кодирования установлен на "multipart/form-data".

Вы также можете передать его напрямую в конструктор URLSearchParams, если хотите сгенерировать параметры запроса так же, как это сделала бы форма <form>, если она использовала простую GET отправку.

Объект, реализующий FormData, можно напрямую использовать в структуре for...of, вместо entries(): for (const p of myFormData) эквивалентно for (const p of myFormData.entries()).

Конструктор

FormData(): Создаёт новый объект FormData.

Методы экземпляра

FormData.append(): Добавляет новое значение к существующему ключу внутри объекта FormData или добавляет ключ, если он ещё не существует.
FormData.delete(): Удаляет пару «ключ-значение» из объекта FormData.
FormData.entries(): Возвращает итератор, который перебирает все пары «ключ-значение», содержащиеся в FormData.
FormData.get(): Возвращает первое значение, связанное с заданным ключом из объекта FormData.
FormData.getAll(): Возвращает массив всех значений, связанных с заданным ключом из FormData.
FormData.has(): Возвращает, содержит ли объект FormData определённый ключ.
FormData.keys(): Возвращает итератор, перебирающий все ключи пар «ключ-значение», содержащихся в FormData.
FormData.set(): Устанавливает новое значение для существующего ключа внутри объекта FormData или добавляет ключ/значение, если он ещё не существует.
FormData.values(): Возвращает итератор, перебирающий все значения, содержащиеся в FormData.

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

Спецификация
XMLHttpRequest # interface-formdata

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

	Стационарные компьютеры					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`@@iterator`	50	18	44	37	11.1	50	44	37	11.3	5.0	50
`FormData`	5	12	4	12	5	18	4	12	5	1.0	3
`FormData`	5	12	4 Перед Firefox 7, при указании `Blob` в качестве данных для добавления в объект, имя файла, сообщаемое в `Content-Disposition` HTTP-заголовке, было пустой строкой, что приводило к ошибкам на некоторых серверах. Начиная с Firefox 7, имя файла `blob` отправляется.	12	5	18	4 Перед Firefox для Android 7, при указании `Blob` в качестве данных для добавления в объект, имя файла, сообщаемое в `Content-Disposition` HTTP-заголовке, было пустой строкой, что приводило к ошибкам на некоторых серверах. Начиная с Firefox для Android 7, имя файла `blob` отправляется.	12	5	1.0	3 XHR в Android 4.0 отправляет пустое содержимое для `FormData` с `blob`.
`append`	5	12	4 Перед Firefox 7, при указании `Blob` в качестве данных для добавления в объект, имя файла, сообщаемое в `Content-Disposition` HTTP-заголовке, было пустой строкой, что приводило к ошибкам на некоторых серверах. Начиная с Firefox 7, имя файла `blob` отправляется.	12	5	18	4 Перед Firefox для Android 7, при указании `Blob` в качестве данных для добавления в объект, имя файла, сообщаемое в `Content-Disposition` HTTP-заголовке, было пустой строкой, что приводило к ошибкам на некоторых серверах. Начиная с Firefox для Android 7, имя файла `blob` отправляется.	12	5	1.0	3 XHR в Android 4.0 отправляет пустое содержимое для `FormData` с `blob`.
`values`	50	18	44	37	11.1	50	44	37	11.3	5.0	50
`worker_support`	50	79	39	37	13.1	50	39	37	13.4	5.0	50

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FormData