Das FormData-Interface ermöglicht das einfache Erstellen eines Objektes bestehend aus Schlüssel/Werte-Paaren, welche Formular-Felder und ihre Werte repräsentieren. Dieses Objekt kann leicht durch das Aufrufen der XMLHttpRequest.send() Methode abgeschickt werden. Es verwendet das gleiche Format wie ein HTML-Formular, dessen Kodierung auf "multipart/form-data" gesetzt wurde.

Ein Objekt, dass FormData implementiert, kann direkt in den for...of Strukturen benutzt werden, statt entries() zu verwenden: for (var p of myFormData) ist identisch zu for (var p of myFormData.entries()).

Hinweis: Dieses Feature ist in  Web Workers verfügbar.

Konstruktor

FormData()
Erzeugt ein neues FormData-Objekt.

Methoden

FormData.append()
Fügt den Wert an den Wert eines bestehenden Schlüssel/Wert-Paares in einem FormData-Objekt an, oder fügt den Schlüssel mit dem Wert hinzu hinzu, falls dieser nicht vorhanden ist.
FormData.delete()
Löscht ein Schlüssel/Wert-Paar aus einem FormData-Objekt.
FormData.entries()
Gibt einen iterator zurück, welcher das Iterieren über alle Schlüssel/Wert-Paare ermöglicht.
FormData.get()
Gibt den ersten Wert zurück, welcher dem gegebenen Schlüssel in dem FormData-Objekt zugeordnet ist.
FormData.getAll()
Erstellt ein Array, welches alle dem gegebenen Schlüssel zugeordneten Werte enthält.
FormData.has()
Gibt einen boolean zurück, welcher Auskunft über das Vorhandenseins des gegeben Schlüssels im FormData-Objekt gibt.
FormData.keys()
Gibt einen iterator zurück, welcher das Iterieren über alle Schlüssel der Schlüssel/Wert-Paare ermöglicht.
FormData.set()
Ersetzt den Wert für einen bestimmten Schlüssel im FormData-Objekt, oder legt das Schlüssel/Wert-Paar an, sollte der Schlüssel noch nicht existieren.
FormData.values()
Gibt einen iterator zurück, welcher das Iterieren über alle Werte der Schlüsselpaare ermöglicht.

Spezifikationen

Spezifikation Status Kommentar
XMLHttpRequest
Die Definition von 'FormData' in dieser Spezifikation.
Lebender Standard FormData definiert in XHR Spezifikation

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung Internet
FormDataChrome Vollständige Unterstützung 7Edge Vollständige Unterstützung JaFirefox Vollständige Unterstützung 4
Hinweise
Vollständige Unterstützung 4
Hinweise
Hinweise Prior to Firefox 7, specifying a Blob as the data to append to the object, the filename reported in the Content-Disposition HTTP header was an empty string, resulting in errors on some servers. Starting with Firefox 7, the filename blob is sent.
IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 12Safari Vollständige Unterstützung 5WebView Android Vollständige Unterstützung Ja
Hinweise
Vollständige Unterstützung Ja
Hinweise
Hinweise XHR in Android 4.0 sends empty content for FormData with blob.
Chrome Android Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung 12Safari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung Ja
FormData() constructorChrome Vollständige Unterstützung 7Edge Vollständige Unterstützung JaFirefox Vollständige Unterstützung 4IE Vollständige Unterstützung 10Opera Vollständige Unterstützung 12Safari Vollständige Unterstützung 5WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung JaOpera Android Vollständige Unterstützung 12Safari iOS ? Samsung Internet Android ?
appendChrome Vollständige Unterstützung 7Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 4
Hinweise
Vollständige Unterstützung 4
Hinweise
Hinweise Prior to Firefox 7, specifying a Blob as the data to append to the object, the filename reported in the Content-Disposition HTTP header was an empty string, resulting in errors on some servers. Starting with Firefox 7, the filename blob is sent.
IE Vollständige Unterstützung 10
Hinweise
Vollständige Unterstützung 10
Hinweise
Hinweise With the "Include local directory pass when uploading files to a server" option enabled, IE will change the filename inside the Blob on the fly. To have direct control of the sent filename, the developer should send the filename as the third parameter value, i.e. formData.append(name, value, filename).
Opera Vollständige Unterstützung 12Safari Vollständige Unterstützung 5WebView Android Vollständige Unterstützung 3
Hinweise
Vollständige Unterstützung 3
Hinweise
Hinweise XHR in Android 4.0 sends empty content for FormData with blob.
Chrome Android Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung 4
Hinweise
Vollständige Unterstützung 4
Hinweise
Hinweise Prior to Firefox 7, specifying a Blob as the data to append to the object, the filename reported in the Content-Disposition HTTP header was an empty string, resulting in errors on some servers. Starting with Firefox 7, the filename blob is sent.
Opera Android Vollständige Unterstützung 12Safari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung Ja
deleteChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung JaOpera Android Vollständige Unterstützung JaSafari iOS Keine Unterstützung NeinSamsung Internet Android Vollständige Unterstützung Ja
getChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung JaOpera Android Vollständige Unterstützung JaSafari iOS Keine Unterstützung NeinSamsung Internet Android Vollständige Unterstützung Ja
getAllChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung JaOpera Android Vollständige Unterstützung JaSafari iOS Keine Unterstützung NeinSamsung Internet Android Vollständige Unterstützung Ja
hasChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung JaOpera Android Vollständige Unterstützung JaSafari iOS Keine Unterstützung NeinSamsung Internet Android Vollständige Unterstützung Ja
setChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Keine Unterstützung NeinSafari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung JaOpera Android Keine Unterstützung NeinSafari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung Ja
entriesChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 44IE Keine Unterstützung NeinOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung 50Chrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung 44Opera Android Vollständige Unterstützung JaSafari iOS ? Samsung Internet Android ?
keysChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 44IE ? Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung 50Chrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung 44Opera Android ? Safari iOS ? Samsung Internet Android ?
valuesChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 44IE ? Opera ? Safari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung 50Chrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung 44Opera Android ? Safari iOS ? Samsung Internet Android ?
Support of for...ofChrome Vollständige Unterstützung 50Edge Keine Unterstützung NeinFirefox Vollständige Unterstützung 44IE ? Opera ? Safari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung 50Chrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung 44Opera Android ? Safari iOS ? Samsung Internet Android ?
Available in workersChrome Vollständige Unterstützung JaEdge Vollständige Unterstützung JaFirefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Vollständige Unterstützung JaSafari Keine Unterstützung NeinWebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung JaOpera Android Vollständige Unterstützung JaSafari iOS Keine Unterstützung NeinSamsung Internet Android ?

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Keine Unterstützung  
Keine Unterstützung
Kompatibilität unbekannt  
Kompatibilität unbekannt
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Mitwirkende an dieser Seite: kaljak, mdnwebdocs-bot, niorad, amelzer, Craeckerffm, ageiss, julidau
Zuletzt aktualisiert von: kaljak,