FormData
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die FormData-Schnittstelle bietet eine Möglichkeit, ein Set von Schlüssel/Wert-Paaren zu erstellen, die Formularfelder und deren Werte darstellen. Diese können mit den Methoden fetch(), XMLHttpRequest.send() oder navigator.sendBeacon() gesendet werden. Sie verwendet dasselbe Format, das ein Formular verwenden würde, wenn der Codierungstyp auf "multipart/form-data" gesetzt wäre.
Sie können es auch direkt an den URLSearchParams-Konstruktor übergeben, wenn Sie Abfrageparameter auf die Weise generieren möchten, wie ein <form> es tun würde, wenn es eine einfache GET-Übermittlung verwenden würde.
Ein Objekt, das FormData implementiert, kann direkt in einer for...of-Struktur verwendet werden, anstelle von entries(): for (const p of myFormData) ist äquivalent zu for (const p of myFormData.entries()).
Konstruktor
FormData()-
Erstellt ein neues
FormData-Objekt.
Instanzmethoden
FormData.append()-
Fügt einem bestehenden Schlüssel innerhalb eines
FormData-Objekts einen neuen Wert hinzu oder fügt den Schlüssel hinzu, wenn er noch nicht existiert. FormData.delete()-
Löscht ein Schlüssel/Wert-Paar aus einem
FormData-Objekt. FormData.entries()-
Gibt einen Iterator zurück, der durch alle in
FormDataenthaltenen Schlüssel/Wert-Paare iteriert. FormData.get()-
Gibt den ersten mit einem bestimmten Schlüssel innerhalb eines
FormData-Objekts verbundenen Wert zurück. FormData.getAll()-
Gibt ein Array aller mit einem bestimmten Schlüssel innerhalb eines
FormDataverbundenen Werte zurück. FormData.has()-
Gibt zurück, ob ein
FormData-Objekt einen bestimmten Schlüssel enthält. FormData.keys()-
Gibt einen Iterator zurück, der durch alle Schlüssel der in
FormDataenthaltenen Schlüssel/Wert-Paare iteriert. FormData.set()-
Setzt einen neuen Wert für einen bestehenden Schlüssel innerhalb eines
FormData-Objekts oder fügt den Schlüssel/Wert hinzu, wenn er noch nicht existiert. FormData.values()-
Gibt einen Iterator zurück, der durch alle in
FormDataenthaltenen Werte iteriert.
Spezifikationen
| Specification |
|---|
| XMLHttpRequest Standard # interface-formdata |
Browser-Kompatibilität
BCD tables only load in the browser