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

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 getAll() de l'interface FormData retourne toutes les valeurs associées à une clé donnée à partir d'un objet FormData.

Syntaxe

js
getAll(name)

Paramètres

name

Une chaîne de caractères représentant le nom de la clé que vous souhaitez retrouver.

Valeur de retour

Un tableau de valeurs dont la clé correspond au name défini. Sinon, une liste vide.

Exemples

Si nous ajoutons deux valeurs username à un FormData en utilisant append() :

js
formData.append("username", "Chris");
formData.append("username", "Bob");

La méthode getAll() suivante retourner les deux valeurs username dans un tableau :

js
formData.getAll("username"); // Retourne ["Chris", "Bob"]

Spécifications

Spécification
XMLHttpRequest
# dom-formdata-getall

Compatibilité des navigateurs

Voir aussi