FormData

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 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 10Opera Vollständige Unterstützung 12Safari Vollständige Unterstützung 5WebView Android Vollständige Unterstützung ≤37
Hinweise
Vollständige Unterstützung ≤37
Hinweise
Hinweise XHR in Android 4.0 sends empty content for FormData with blob.
Chrome Android Vollständige Unterstützung 18Firefox 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 5Samsung Internet Android Vollständige Unterstützung 1.0
FormData() constructorChrome Vollständige Unterstützung 7Edge Vollständige Unterstützung 12Firefox 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 ≤37Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung 12Safari iOS Vollständige Unterstützung 5Samsung Internet Android Vollständige Unterstützung 1.0
Support of for...ofChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 79Firefox 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 Vollständige Unterstützung 11Samsung Internet Android Vollständige Unterstützung 5.0
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 18Firefox 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 5Samsung Internet Android Vollständige Unterstützung 1.0
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 5.0
entriesChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 44IE Keine Unterstützung NeinOpera Vollständige Unterstützung 37Safari 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 37Safari iOS Vollständige Unterstützung 11Samsung Internet Android Vollständige Unterstützung 5.0
getChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Vollständige Unterstützung 37Safari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung 50Chrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung 39Opera Android Vollständige Unterstützung 37Safari iOS Vollständige Unterstützung 11Samsung Internet Android Vollständige Unterstützung 5.0
getAllChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Vollständige Unterstützung 37Safari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung 50Chrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung 39Opera Android Vollständige Unterstützung 37Safari iOS Vollständige Unterstützung 11Samsung Internet Android Vollständige Unterstützung 5.0
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 5.0
keysChrome 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 ? Safari iOS Vollständige Unterstützung 11Samsung Internet Android Vollständige Unterstützung 5.0
setChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 39IE Keine Unterstützung NeinOpera Vollständige Unterstützung 37Safari Vollständige Unterstützung 11WebView Android Vollständige Unterstützung 50Chrome Android Vollständige Unterstützung 50Firefox Android Vollständige Unterstützung 39Opera Android Vollständige Unterstützung 37Safari iOS Vollständige Unterstützung 11Samsung Internet Android Vollständige Unterstützung 5.0
valuesChrome Vollständige Unterstützung 50Edge Vollständige Unterstützung 18Firefox Vollständige Unterstützung 44IE Keine Unterstützung NeinOpera Vollständige Unterstützung 37Safari 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 37Safari iOS Vollständige Unterstützung 11Samsung Internet Android Vollständige Unterstützung 5.0
Available in workersChrome Vollständige Unterstützung JaEdge Vollständige Unterstützung ≤18Firefox 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 Vollständige Unterstützung Ja

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