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

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨octobre 2018⁩.

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

La méthode getAll() de l'interface FormData renvoie toutes les valeurs associées à une clé donnée à partir d'un objet FormData.

Note : Cette méthode est disponible dans les Web Workers.

Syntaxe

js
formData.getAll(name);

Paramètres

name

Un USVString représentant le nom de la clé que vous voulez récupérer.

Retours

Un tableau de FormDataEntryValue dont la clé correspond à la valeur passée dans le paramètre name. Si la clé n'existe pas, la méthode renvoie une liste vide.

Exemple

La ligne suivante crée un objet FormData vide :

js
var formData = new FormData();

Si nous ajoutons deux valeurs username en utilisant FormData.append :

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

La fonction getAll() suivante va retourner chaque valeurs de username dans un tableau :

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

Spécifications

Specification
XMLHttpRequest
# dom-formdata-getall

Compatibilité des navigateurs

Voir aussi