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

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
getAll

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi