FormData

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 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 FormData enthaltenen 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 FormData verbundenen 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 FormData enthaltenen 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 FormData enthaltenen Werte iteriert.

Spezifikationen

Specification
XMLHttpRequest # interface-formdata

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden