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
FormData
contient 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