В процессе перевода.
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.set() и FormData.append() заключается в том, что если указанный ключ найден в объекте, FormData.set() перезапишет его новым значением, тогда как FormData.append() добавит новое значение в конец существующего. Смотрите дополнительные материалы с примерами.
Спецификация
| Спецификация | Статус | Примечание |
|---|---|---|
| XMLHttpRequest Определение 'FormData' в этой спецификации. |
Живой стандарт | FormData defined in XHR spec |
Совместимость
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 7+ | 4.0 (2.0) | 10+ | 12+ | 5+ |
| append with filename | (Да) | 22.0 (22.0) | ? | ? | ? |
| delete, get, getAll, has, set | (Да) | Нет | Нет | (Да) | Нет |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | 3.0 | ? | 4.0 (2.0) | 1.0.1 | ? |
12+ |
? |
| append with filename | ? | ? | 22.0 (22.0) | 1.2 | ? | ? | ? |
| delete, get, getAll, has, set | (Да) | (Да) | Нет | Нет | Нет | (Да) | Нет |
Важно: XHR в Android 4.0 отправляет пустое содержимое для FormData с blob.
Gecko примечание
До Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), если вы указывали Blob в качестве данных для добавления к объекту, имя файла, указанное в заголовке "Content-Disposition" HTTP было пустой строкой - это приводило к ошибкам, сообщаемым некоторыми серверами. Начиная с Gecko 7.0, отправляется имя файла "blob".