Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

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é specified, 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.

Exemple

La ligne suivante crée un objet FormData vide:

var formData = new FormData(); // Currently empty

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. C'est nécessaire pour être capable d'accéder à leurs valeurs après.

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

Specifications

Specification Status Comment
XMLHttpRequest
La définition de 'FormData()' dans cette spécification.
Standard évolutif Initial definition

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simpleChrome 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 OuiEdge Mobile 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

Étiquettes et contributeurs liés au document

Contributeurs à cette page : ThreadElric
Dernière mise à jour par : ThreadElric,