FormData
Das FormData
-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 XMLHttpRequest.send()
(en-US) Methode abgeschickt werden. Es verwendet das gleiche Format wie ein HTML-Formular, dessen Kodierung auf "multipart/form-data"
gesetzt wurde.
Ein Objekt, dass FormData implementiert, kann direkt in den for...of
Strukturen benutzt werden, statt entries()
(en-US) zu verwenden: for (var p of myFormData)
ist identisch zu for (var p of myFormData.entries())
.
Hinweis: Dieses Feature ist in Web Workers verfügbar.
Konstruktor
FormData()
- Erzeugt ein neues
FormData
-Objekt.
Methoden
FormData.append()
(en-US)- Fügt den Wert an den Wert eines bestehenden Schlüssel/Wert-Paares in einem
FormData
-Objekt an, oder fügt den Schlüssel mit dem Wert hinzu hinzu, falls dieser nicht vorhanden ist. FormData.delete()
(en-US)- Löscht ein Schlüssel/Wert-Paar aus einem
FormData
-Objekt. FormData.entries()
(en-US)- Gibt einen
iterator
zurück, welcher das Iterieren über alle Schlüssel/Wert-Paare ermöglicht. FormData.get()
- Gibt den ersten Wert zurück, welcher dem gegebenen Schlüssel in dem
FormData
-Objekt zugeordnet ist. FormData.getAll()
- Erstellt ein Array, welches alle dem gegebenen Schlüssel zugeordneten Werte enthält.
FormData.has()
(en-US)- Gibt einen boolean zurück, welcher Auskunft über das Vorhandenseins des gegeben Schlüssels im
FormData
-Objekt gibt. FormData.keys()
(en-US)- Gibt einen
iterator
zurück, welcher das Iterieren über alle Schlüssel der Schlüssel/Wert-Paare ermöglicht. FormData.set()
(en-US)- Ersetzt den Wert für einen bestimmten Schlüssel im
FormData
-Objekt, oder legt das Schlüssel/Wert-Paar an, sollte der Schlüssel noch nicht existieren. FormData.values()
(en-US)- Gibt einen
iterator
zurück, welcher das Iterieren über alle Werte der Schlüsselpaare ermöglicht.
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
XMLHttpRequest Die Definition von 'FormData' in dieser Spezifikation. |
Lebender Standard | FormData definiert in XHR Spezifikation |
Browserkompatibilität
BCD tables only load in the browser