FormData()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note: Cette fonctionnalité est disponible via les Web Workers.

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

Note : Cette fonctionnalité est disponible dans Web Workers.

Syntaxe

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

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

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

js
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é :

html
<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).

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

Spécifications

Specification
XMLHttpRequest Standard
# dom-formdata

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi