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 : Tous les éléments input doivent avoir un attribut name. Celui-ci est nécessaire afin d'accéder à la valeur des éléments ensuite.

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

Spécifications

Spécification État 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 OuiFirefox Support complet 4IE Support complet 10Opera Support complet 12Safari Support complet 5WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet OuiOpera Android Support complet 12Safari iOS ? Samsung Internet Android ?

Légende

Support complet  
Support complet
Compatibilité inconnue  
Compatibilité inconnue

Voir aussi