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
|
---
title: FormData
slug: Web/API/FormData
tags:
- API
- FomData
- Interface
- Referenz
- XMLHttpRequest
translation_of: Web/API/FormData
---
<p>{{APIRef("XMLHttpRequest")}}</p>
<p>Das <strong><code>FormData</code></strong>-Interface ermöglicht das einfache Erstellen eines Objektes bestehend aus Schlüssel/Werte-Paaren, welche Formular-Felder und ihre Werte repräsentieren. Dieses Objekt kann leicht durch das Aufrufen der {{domxref("XMLHttpRequest.send()")}} Methode abgeschickt werden. Es verwendet das gleiche Format wie ein HTML-Formular, dessen Kodierung auf <code>"multipart/form-data"</code> gesetzt wurde.</p>
<p>Ein Objekt, dass FormData implementiert, kann direkt in den {{jsxref("Statements/for...of", "for...of")}} Strukturen benutzt werden, statt {{domxref('FormData.entries()', 'entries()')}} zu verwenden: <code>for (var p of myFormData)</code> ist identisch zu <code>for (var p of myFormData.entries())</code>.</p>
<div class="note">
<p><strong>Hinweis</strong>: Dieses Feature ist in <a href="/en-US/docs/Web/API/Web_Workers_API">Web Workers</a> verfügbar.</p>
</div>
<h2 id="Konstruktor">Konstruktor</h2>
<dl>
<dt>{{domxref("FormData.FormData","FormData()")}}</dt>
<dd>Erzeugt ein neues <code>FormData</code>-Objekt.</dd>
</dl>
<h2 id="Methoden">Methoden</h2>
<dl>
<dt>{{domxref("FormData.append()")}}</dt>
<dd>Fügt den Wert an den Wert eines bestehenden Schlüssel/Wert-Paares in einem <code>FormData</code>-Objekt an, oder fügt den Schlüssel mit dem Wert hinzu hinzu, falls dieser nicht vorhanden ist.</dd>
<dt>{{domxref("FormData.delete()")}}</dt>
<dd>Löscht ein Schlüssel/Wert-Paar aus einem <code>FormData</code>-Objekt.</dd>
<dt>{{domxref("FormData.entries()")}}</dt>
<dd>Gibt einen {{jsxref("Iteration_protocols","iterator")}} zurück, welcher das Iterieren über alle Schlüssel/Wert-Paare ermöglicht.</dd>
<dt>{{domxref("FormData.get()")}}</dt>
<dd>Gibt den ersten Wert zurück, welcher dem gegebenen Schlüssel in dem <code>FormData</code>-Objekt zugeordnet ist.</dd>
<dt>{{domxref("FormData.getAll()")}}</dt>
<dd>Erstellt ein Array, welches alle dem gegebenen Schlüssel zugeordneten Werte enthält.</dd>
<dt>{{domxref("FormData.has()")}}</dt>
<dd>Gibt einen boolean zurück, welcher Auskunft über das Vorhandenseins des gegeben Schlüssels im <code>FormData</code>-Objekt gibt.</dd>
<dt>{{domxref("FormData.keys()")}}</dt>
<dd>Gibt einen {{jsxref("Iteration_protocols", "iterator")}} zurück, welcher das Iterieren über alle Schlüssel der Schlüssel/Wert-Paare ermöglicht.</dd>
<dt>{{domxref("FormData.set()")}}</dt>
<dd>Ersetzt den Wert für einen bestimmten Schlüssel im <code>FormData</code>-Objekt, oder legt das Schlüssel/Wert-Paar an, sollte der Schlüssel noch nicht existieren.</dd>
<dt>{{domxref("FormData.values()")}}</dt>
<dd>Gibt einen {{jsxref("Iteration_protocols", "iterator")}} zurück, welcher das Iterieren über alle Werte der Schlüsselpaare ermöglicht.</dd>
</dl>
<h2 id="Spezifikationen">Spezifikationen</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spezifikation</th>
<th scope="col">Status</th>
<th scope="col">Kommentar</th>
</tr>
<tr>
<td>{{SpecName('XMLHttpRequest','#interface-formdata','FormData')}}</td>
<td>{{Spec2('XMLHttpRequest')}}</td>
<td>FormData definiert in XHR Spezifikation</td>
</tr>
</tbody>
</table>
<h2 id="Browserkompatibilität">Browserkompatibilität</h2>
<p>{{Compat("api.FormData")}}</p>
<h2 id="Siehe_auch">Siehe auch</h2>
<ul>
<li>{{domxref("XMLHTTPRequest")}}</li>
<li><a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">XMLHttpRequest benutzen</a></li>
<li><a href="/en-US/docs/Web/API/FormData/Using_FormData_Objects">FormData-Objekte benutzen</a></li>
<li>{{HTMLElement("Form")}}</li>
</ul>
|
