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.
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. Elle 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()-
Renvoie un itérateur 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()-
Renvoie un tableau de toutes les valeurs associées à une clé donnée à partir d'un objet
FormData. FormData.has()-
Renvoie un booléen indiquant si un objet
FormDatacontient une certaine clé. FormData.keys()-
Renvoie un itérateur 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()-
Renvoie un itérateur permettant de parcourir toutes les valeurs contenues dans cet objet.
Spécifications
| Specification |
|---|
| XMLHttpRequest Standard # interface-formdata |
Compatibilité des navigateurs
BCD tables only load in the browser