Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

FormData : méthode values()

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 octobre 2018.

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

La méthode FormData.values() retourne un itérateur permettant de passer en revue toutes les valeurs contenues dans le FormData. Les valeurs sont des chaînes de caractères ou des objets Blob.

Note : Les clés de FormData ne sont pas nécessairement uniques. Un formulaire peut contenir plusieurs éléments portant le même nom, de sorte que les valeurs partageant une même clé apparaissent chacune lors de l'itération. Pour récupérer toutes les valeurs associées à une seule clé, utilisez la méthode getAll() (ou get() pour uniquement la première valeur).

Syntaxe

js
values()

Valeur de retour

Un itérateur des valeurs du FormData.

Exemples

js
const formData = new FormData();
formData.append("cle1", "valeur1");
formData.append("cle2", "valeur2");

// Affiche les valeurs
for (const valeur of formData.values()) {
  console.log(valeur);
}

Le résultat est :

valeur1
valeur2

Spécifications

Spécification
XMLHttpRequest
# interface-formdata

Compatibilité des navigateurs

Voir aussi