FormData

L'interface FormData permet de construire facilement un ensemble de paires clé/valeur représentant les champs du formulaire et leurs valeurs, qui peuvent ensuite être facilement envoyées en utilisant la méthode XMLHttpRequest.send() de l'objet XMLHttpRequest. Il utilise le même format qu'utilise un formulaire si le type d'encodage est mis à "multipart/form-data".

Vous pouvez également le passer directement au constructeur URLSearchParams si vous souhaitez générer des paramètres de requête de la même manière qu'un <form> le ferait s'il utilisait une simple soumission GET.

Un objet implémentant FormData peut être utilisé directement dans une structure for...of, au lieu de entries() : for (var p of myFormData) est équivalent à for (var p of myFormData.entries()).

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

Constructeur

FormData()
Crée un nouvel objet FormData.

Méthodes

FormData.append()
Ajoute une nouvelle valeur à une clé existante dans un objet FormData, ou ajoute la clé si elle n'existe pas encore.
FormData.delete()
Supprime une paire clé/valeur d'un objet FormData.
FormData.entries()
Retourne une itération permettant de passer en revue toutes les paires clé/valeur contenues dans cet objet.
FormData.get()
Renvoie la première valeur associée à une clé donnée à partir d'un objet FormData.
FormData.getAll()
Retourne un tableau de toutes les valeurs associées à une clé donnée à partir d'un FormData.
FormData.has()
Renvoie un booléen indiquant si un objet FormData contient une certaine clé.
FormData.keys()
Retourne une itération permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet.
FormData.set()
Définit une nouvelle valeur pour une clé existante dans un objet FormData, ou ajoute la clé/valeur si elle n'existe pas encore.
FormData.values()
Retourne une itération permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet.

Spécifications

Spécification Statut Commentaire
XMLHttpRequest
La définition de 'FormData' dans cette spécification.
Standard évolutif FormData définit dans les specs XHR

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi