Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

FormData — créer et examiner des données de formulaire

FormData stocke des paires nom-valeur ordonnées, y compris lorsque les noms se répètent. Découvrez la différence entre append() et set(), l’itération avec entries() et l’envoi des données avec fetch().

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const data = new FormData();
data.append(name, value);
data.set(name, value);
data.set(name, blob, filename);
for (const [name, value] of data.entries()) { /* ... */ }

FormData est une interface de l’API Web, et non un élément d’ECMAScript lui-même. Elle stocke une liste ordonnée de paires nom-valeur ; les noms peuvent se répéter. Les valeurs sont des chaînes ou des objets File. Vous pouvez fournir un Blob, qui sera stocké comme un fichier. Pour les autres valeurs, la conversion en chaîne suit les règles de Web IDL. Passer une valeur de type Symbol à append() ou à set() déclenche une exception TypeError lors de cette conversion ; aucune chaîne n’est stockée.

append(name, value) ajoute une entrée tout en conservant les entrées précédentes portant le même nom. FormData.set, appelé sous la forme data.set(name, value), remplace la première entrée correspondante et supprime les autres entrées portant ce nom. Si le nom n’existe pas, une entrée est ajoutée à la fin. Pour un Blob, vous pouvez fournir un troisième argument, filename.

FormData.entries, appelé sous la forme data.entries(), renvoie un itérateur de paires [name, value] dans l’ordre des entrées. Dans l’exemple, set("tag", "api") laisse une seule entrée tag à la position de la première entrée ; elle apparaît donc avant name. Il ne s’agit pas d’un objet simple : la conversion en objet ne préservera pas plusieurs valeurs sous le même nom.

Lors de l’envoi avec fetch(url, { method: "POST", body: data }), ne définissez pas manuellement l’en-tête Content-Type : le navigateur crée multipart/form-data avec un paramètre boundary correspondant. L’exemple n’envoie aucune requête. Vérifiez la disponibilité de l’API dans le navigateur cible ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.

Exemples

const data = new FormData();
data.append("tag", "javascript");
data.append("tag", "web");
data.set("name", "Ada");
data.set("tag", "api");

for (const [name, value] of data.entries()) {
  console.log(`${name}=${value}`);
}

Résultat

tag=api
name=Ada

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources