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 keys()

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.keys() de l'interface FormData retourne un itérateur permettant de parcourir toutes les clés contenues dans cet objet. Les clés sont des chaînes de caractères.

Note : Contrairement aux clés de Map, 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 la même clé peut apparaître plusieurs fois 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
keys()

Paramètres

Aucun.

Valeur de retour

Un itérateur des clés de FormData.

Exemples

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

// Affiche les clés
for (const cle of formData.keys()) {
  console.log(cle);
}

Le résultat est :

cle1
cle2

Spécifications

Spécification
XMLHttpRequest
# interface-formdata

Compatibilité des navigateurs

Voir aussi