Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

FormData: FormData()-Konstruktor

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Der FormData()-Konstruktor erstellt ein neues FormData-Objekt.

Syntax

js
new FormData()
new FormData(form)
new FormData(form, submitter)

Parameter

form Optional

Ein HTML-<form>-Element. Wenn es angegeben wird, wird das FormData-Objekt mit den aktuellen Schlüsseln und Werten des form-Elements befüllt. Als Schlüssel wird jeweils die name-Eigenschaft eines Elements verwendet, als Wert dessen übermittelter Wert. Auch der Inhalt von Dateieingaben wird kodiert. Beim Erstellen des FormData-Objekts wird auf dem Formular ein formdata-Ereignis ausgelöst, sodass die Formulardaten bei Bedarf geändert werden können.

submitter Optional

Ein Submit-Button, der zum form gehört. Wenn submitter ein name-Attribut hat oder ein <input type="image"> ist, werden seine Daten in das Objekt aufgenommen (z. B. btnName=btnValue).

Ausnahmen

TypeError

Wird ausgelöst, wenn der angegebene submitter kein Submit-Button ist.

NotFoundError DOMException

Wird ausgelöst, wenn der angegebene submitter nicht zum form gehört. submitter muss entweder ein Nachfahre des Formularelements sein oder ein form-Attribut haben, das auf das Formular verweist.

Beispiele

Ein leeres FormData-Objekt erstellen

Die folgende Zeile erstellt ein leeres FormData-Objekt:

js
const formData = new FormData();

Mit append() können Sie ein Schlüssel-Wert-Paar hinzufügen:

js
formData.append("username", "Chris");

Werte aus einem HTML-Formularelement übernehmen

Beim Erstellen des FormData-Objekts können Sie die optionalen Argumente form und submitter angeben, um es mit Werten aus dem angegebenen Formular zu befüllen.

Hinweis: In ein FormData-Objekt werden nur erfolgreiche Formularelemente aufgenommen, also solche mit einem Namen, die nicht deaktiviert sind.

HTML

html
<form id="form">
  <input type="text" name="text1" value="foo" />
  <input type="text" name="text2" value="bar" />
  <input type="text" name="text3" value="baz" />
  <input type="checkbox" name="check" checked disabled />
  <button name="intent" value="save">Save</button>
  <button name="intent" value="saveAsCopy">Save As Copy</button>
</form>

<output id="output"></output>

JavaScript

js
const form = document.getElementById("form");
const submitter = document.querySelector("button[value=save]");
const formData = new FormData(form, submitter);

const output = document.getElementById("output");

for (const [key, value] of formData) {
  output.textContent += `${key}: ${value}\n`;
}

Ergebnis

Der Übersichtlichkeit halber ist das <form>-Element ausgeblendet.

Spezifikationen

Spezifikation
XMLHttpRequest
# dom-formdata

Browser-Kompatibilität

Siehe auch