FormData()

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

Anmerkung: Dieses Feature is verf├╝gbar auf Web Workers.

Syntax

var formData = new FormData(form)

Parameter

form Optional
Ein HTML <form>-Element ÔÇö wenn angegeben, wird  das neue FormData-Objekt mit den aktuellen Schl├╝ssel/Wert-Paaren des form's gef├╝llt, wobei "name" der Schl├╝ssel und "value" der Wert. Mitgeschickte Dateien werden ebenfalls codiert.

Example

So erzeugt man ein neues FormData-Objekt:

var formData = new FormData(); // leer

Nun kann man ein Schl├╝ssel/Wert-Paar hinzuf├╝gen mit FormData.append:

formData.append('username', 'Chris');

Oder man gibt das optionale form Argument an, um es direkt mit dessen Werten zu f├╝llen:

<form id="myForm" name="myForm">
  <div>
    <label for="username">Enter name:</label>
    <input type="text" id="username" name="username">
  </div>
  <div>
    <label for="useracc">Enter account number:</label>
    <input type="text" id="useracc" name="useracc">
  </div>
  <div>
    <label for="userfile">Upload file:</label>
    <input type="file" id="userfile" name="userfile">
  </div>
<input type="submit" value="Submit!">
</form>

Anmerkung: Alle input-Elemente haben das 'name'-Attribut. Das ist notwendig um die Werte auszuwerten.

var myForm = document.getElementById('myForm');
formData = new FormData(myForm);

Spezifikationen

Specification Status Comment
XMLHttpRequest
Die Definition von 'FormData()' in dieser Spezifikation.
Lebender Standard Initial definition

Gecko notes

Browserkompatibilit├Ąt

Wir konvertieren die Kompatibilit├Ątsdaten in ein maschinenlesbares JSON Format. Diese Kompatibilit├Ątstabelle liegt noch im alten Format vor, denn die darin enthaltenen Daten wurden noch nicht konvertiert. Finde heraus wie du helfen kannst!
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 7 4.0 (2.0) 10 12 5
append with filename (Ja) 22.0 (22.0) ? ? ?
available in web workers (Ja) 39.0 (39.0) (Ja) (Ja) (Ja)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 3.0 ? 4.0 (2.0) ?

12

?
append with filename ? ? 22.0 (22.0) ? ? ?
Available in web workers ? ? 39.0 (39.0) ? ? ?

 

Note: XHR in Android 4.0 sends empty content for FormData with blob.

Prior to Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), if you specified a Blob as the data to append to the object, the filename reported in the "Content-Disposition" HTTP header was an empty string; this resulted in errors being reported by some servers. Starting in Gecko 7.0, the filename "blob" is sent.

See also