FormData()

Le constructeur FormData() crée un nouvel objet FormData.

Note : Cette fonctionnalité est disponible dans Web Workers.

Syntaxe

var formData = new FormData(form)

Paramètres

form Facultatif
Un element HTML <form> — quand il est spécifié, l'objet FormData sera rempli avec les clés/valeurs du formulaire en utilisant les noms de propriétés de chaque élément pour clé et les valeurs soumises. Cela encodera aussi le contenu des fichiers.

Exemples

La ligne suivante crée un objet FormData vide:

var formData = new FormData(); // Formulaire vide à cet instant

Vous pouvez ajouter un couple clé/valeur en utilisant FormData.append :

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

Ou vous pouvez spécifier l'argument optionnel form à la création de l'objet FormData pour le pré-remplir avec les valeurs issues du formulaire spécifié :

<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>

Note : Seuls les champs de formulaires valides sont inclus dans un objet FormData, c'est-à-dire ceux qui portent un nom (attribut name), qui ne sont pas désactivés et qui sont cochés (boutons radio et cases à cocher) ou sélectionnés (une ou plusieurs options dans une sélection).

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

Spécifications

Spécification Statut Commentaires
XMLHttpRequest
La définition de 'FormData()' dans cette spécification.
Standard évolutif Définition initiale.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
FormData() constructorChrome Support complet 7Edge Support complet 12Firefox Support complet 4IE Support complet 10Opera Support complet 12Safari Support complet 5WebView Android Support complet ≤37Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 12Safari iOS Support complet 5Samsung Internet Android Support complet 1.0

Légende

Support complet  
Support complet

Voir aussi