FormData
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Note : Cette fonctionnalité est disponible via les Web Workers.
L'interface FormData fournit un moyen de construire un ensemble de paires clé/valeur représentant les champs du formulaire et leurs valeurs, qui peuvent être envoyées en utilisant les méthodes fetch(), XMLHttpRequest.send() ou navigator.sendBeacon(). Elle utilise le même format qu'un formulaire utilise si le type d'encodage était défini sur "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 un simple envoi GET.
Un objet implémentant FormData peut être utilisé directement dans une structure for...of, au lieu de entries() : for (const p of myFormData) est équivalent à for (const p of myFormData.entries()).
Constructeur
FormData()-
Crée un nouvel objet
FormData.
Méthodes d'instance
FormData.append()-
Ajoute une nouvelle valeur à une clé existante au sein d'un objet
FormData, ou crée la clé si elle n'existe pas encore. FormData.delete()-
Supprime une paire clé/valeur d'un objet
FormData. FormData.entries()-
Retourne un itérateur qui parcourt toutes les paires clé/valeur contenues dans l'objet
FormData. FormData.get()-
Retourne la première valeur associée à une clé donnée dans un objet
FormData. FormData.getAll()-
Retourne un tableau de toutes les valeurs associées à une clé donnée dans un objet
FormData. FormData.has()-
Retourne un booléen si un objet
FormDatacontient une clé donnée. FormData.keys()-
Retourne un itérateur qui parcourt toutes les clés des paires clé/valeur contenues dans l'objet
FormData. FormData.set()-
Définit une nouvelle valeur pour une clé existante au sein d'un objet
FormData, ou ajoute la paire clé/valeur si elle n'existe pas encore. FormData.values()-
Retourne un itérateur qui parcourt toutes les valeurs contenues dans l'objet
FormData.
Spécifications
| Spécification |
|---|
| XMLHttpRequest # interface-formdata |
Compatibilité des navigateurs
Voir aussi
- Utiliser des objets
FormData - L'élément HTML
<form>