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 July 2015.

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 Standard
# dom-formdata-getall

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi