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
new FormData()
new FormData(form)
new FormData(form, submitter)
Parameter
formOptional-
Ein HTML-
<form>-Element. Wenn es angegeben wird, wird dasFormData-Objekt mit den aktuellen Schlüsseln und Werten desform-Elements befüllt. Als Schlüssel wird jeweils diename-Eigenschaft eines Elements verwendet, als Wert dessen übermittelter Wert. Auch der Inhalt von Dateieingaben wird kodiert. Beim Erstellen desFormData-Objekts wird auf dem Formular einformdata-Ereignis ausgelöst, sodass die Formulardaten bei Bedarf geändert werden können. submitterOptional-
Ein Submit-Button, der zum
formgehört. Wennsubmittereinname-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
submitterkein Submit-Button ist. NotFoundErrorDOMException-
Wird ausgelöst, wenn der angegebene
submitternicht zumformgehört.submittermuss entweder ein Nachfahre des Formularelements sein oder einform-Attribut haben, das auf das Formular verweist.
Beispiele
>Ein leeres FormData-Objekt erstellen
Die folgende Zeile erstellt ein leeres FormData-Objekt:
const formData = new FormData();
Mit append() können Sie ein Schlüssel-Wert-Paar hinzufügen:
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
<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
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> |