CKTIS / JavaScript
FormData — Formulardaten erstellen und untersuchen
FormData speichert geordnete Name-Wert-Paare, auch mit wiederholten Namen. Erfahre den Unterschied zwischen append() und set(), wie du mit entries() iterierst und wie du die Daten mit fetch() sendest.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const data = new FormData();
data.append(name, value);
data.set(name, value);
data.set(name, blob, filename);
for (const [name, value] of data.entries()) { /* ... */ }FormData ist eine Web-API-Schnittstelle und kein Bestandteil von ECMAScript selbst. Sie speichert eine geordnete Liste von Name-Wert-Paaren; Namen dürfen mehrfach vorkommen. Werte sind Zeichenfolgen oder File-Objekte. Du kannst ein Blob übergeben, das als Datei gespeichert wird. Für andere Werte gelten die Regeln von Web IDL zur Umwandlung in Zeichenfolgen. Wenn du einen Symbol-Wert an append() oder set() übergibst, wird bei dieser Umwandlung ein TypeError ausgelöst; es wird keine Zeichenfolge gespeichert.
append(name, value) fügt einen Eintrag hinzu und behält frühere Einträge mit demselben Namen bei. FormData.set, aufgerufen als data.set(name, value), ersetzt den ersten passenden Eintrag und entfernt die übrigen Einträge mit diesem Namen. Falls der Name nicht existiert, wird ein Eintrag angehängt. Für ein Blob kannst du ein drittes Argument, filename, angeben.
FormData.entries, aufgerufen als data.entries(), gibt einen Iterator mit [name, value]-Paaren in der Reihenfolge der Einträge zurück. Im Beispiel lässt set("tag", "api") einen tag-Eintrag an der Position des ersten Eintrags übrig, daher erscheint er vor name. Dies ist kein einfaches Objekt: Bei der Umwandlung in ein Objekt bleiben mehrere Werte unter demselben Namen nicht erhalten.
Beim Senden mit fetch(url, { method: "POST", body: data }) solltest du den Content-Type-Header nicht manuell setzen: Der Browser erstellt multipart/form-data mit einem passenden boundary-Parameter. Das Beispiel sendet keine Anfrage. Prüfe die Verfügbarkeit der API im Zielbrowser; das Vorhandensein von Node 24 in einem Repository belegt keine Browserunterstützung.
Beispiele
const data = new FormData();
data.append("tag", "javascript");
data.append("tag", "web");
data.set("name", "Ada");
data.set("tag", "api");
for (const [name, value] of data.entries()) {
console.log(`${name}=${value}`);
}Ergebnis
tag=api name=Ada
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.