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.

* Some parts of this feature may have varying levels of support.

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
FormData
[Symbol.iterator]
FormData() constructor
submitter parameter
append
filename parameter
delete
entries
forEach
get
getAll
has
keys
set
values
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Siehe auch