1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
---
title: FormData
slug: Web/API/FormData
tags:
- API
- FormData
- Interface
- Reference
- XMLHttpRequest
translation_of: Web/API/FormData
---
<p>{{APIRef("XMLHttpRequest")}}</p>
<p>XMLHttpRequest 2 добавляет поддержку для нового интерфейса FormData. Объекты FormData позволяют вам легко конструировать наборы пар ключ-значение, представляющие поля формы и их значения, которые в дальнейшем можно отправить с помощью метода <a href="/en-US/docs/DOM/XMLHttpRequest#send()" title="XMLHttpRequest#send()"><code>send()</code></a>.</p>
<p>FormData использует такой же формат на выходе, как если бы мы отправляли обыкновенную форму с encoding установленным в "multipart/form-data".</p>
<div class="note">
<p><strong>Важно</strong>: О деталях использования FormData можно прочитать в статье <a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Использование объекта FormData</a>.</p>
</div>
<h2 id="Syntax" name="Syntax">Конструктор</h2>
<dl>
<dt>{{domxref("FormData.FormData","FormData()")}}</dt>
<dd>Создаёт объект <code>FormData</code>.</dd>
</dl>
<h2 id="Методы">Методы</h2>
<dl>
<dt>{{domxref("FormData.append()")}}</dt>
<dd>Добавляет новое значение существующего поля объекта <code style="font-style: normal;">FormData</code>, либо создаёт его и присваивает значение.</dd>
<dt>{{domxref("FormData.delete()")}}</dt>
<dd>Удаляет пару ключ-значение из объекта <code>FormData</code>.</dd>
<dt>{{domxref("FormData.get()")}}</dt>
<dd>Возвращает первое значение ассоциированное с переданным ключом из объекта <code>FormData</code>.</dd>
<dt>{{domxref("FormData.getAll()")}}</dt>
<dd>Возвращает массив всех значений ассоциированных с переданным ключом из объекта <code style="font-style: normal;">FormData</code>.</dd>
<dt>{{domxref("FormData.has()")}}</dt>
<dd>Возвращает булево значение касательно наличия в объекте <code style="font-style: normal;">FormData</code> конкретной пары ключ-значение.</dd>
<dt>{{domxref("FormData.set()")}}</dt>
<dd>Устанавливает новое значение для существующего ключа объекта <code style="font-style: normal;">FormData</code>, или добавляет пару ключ-значение, если таковой не обнаружено в объекте.</dd>
<dt>{{domxref("FormData.keys()")}}</dt>
<dd>Возвращает {{jsxref("Iteration_protocols", "iterator")}} , который позволяет пройтись по всем ключам для каждой пары "ключ-значение" , содержащимся внутри объекта <code style="font-style: normal;">FormData</code></dd>
<dt>{{domxref("FormData.entries()")}}</dt>
<dd>Возвращает {{jsxref("Iteration_protocols","iterator")}} который позволяет пройтись по всем парам "ключ-значение", содержащимся внутри объекта <code style="font-style: normal;">FormData</code></dd>
<dt>{{domxref("FormData.values()")}}</dt>
<dd>Возвращает {{jsxref("Iteration_protocols", "iterator")}} , который позволяет пройтись по всем значениям , содержащимся в объекте <code style="font-style: normal;">FormData</code></dd>
</dl>
<div class="note">
<p><strong>Важно</strong>: Разница между {{domxref("FormData.set()")}} и {{domxref("FormData.append()")}} заключается в том, что если указанный ключ найден в объекте, {{domxref("FormData.set()")}} перезапишет его новым значением, тогда как {{domxref("FormData.append()")}} добавит новое значение в конец существующего. Смотрите дополнительные материалы с примерами. </p>
</div>
<h2 id="Спецификация">Спецификация</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Спецификация</th>
<th scope="col">Статус</th>
<th scope="col">Примечание</th>
</tr>
<tr>
<td>{{SpecName('XMLHttpRequest','#interface-formdata','FormData')}}</td>
<td>{{Spec2('XMLHttpRequest')}}</td>
<td>FormData определён в XHR spec</td>
</tr>
</tbody>
</table>
<h2 id="Совместимость">Совместимость</h2>
<div class="hidden">Таблица совместимости на этой странице создаётся из структурированных данных. Если вы хотите внести свой вклад в эти данные, пожалуйста, проверьте <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> и отправьте нам запрос на слияние.</div>
<p>{{Compat("api.FormData")}}</p>
<h2 id="Смотрите_также">Смотрите также</h2>
<ul>
<li>{{domxref("XMLHTTPRequest")}}</li>
<li><a href="/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="Using XMLHttpRequest">Using XMLHttpRequest</a></li>
<li><a href="/en-US/docs/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="DOM/XMLHttpRequest/FormData/Using_FormData_objects">Использование объектов FormData</a></li>
<li>{{HTMLElement("Form")}}</li>
</ul>
|
