FormData.get()

La méthode get() de l'interface FormData renvoie la première valeur associée à une clé donnée dans un objet FormData. Si vous souhaitez manipuler plusieurs valeurs et les récupérer intégralement, utilisez plutôt la méthode getAll().

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

Syntaxe

js
formData.get(name);

Paramètres

name

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

Valeur de retour

Un objet FormDataEntryValue (en-US) contenant la valeur. Si la clé n'existe pas, la méthode renvoie null.

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");

L'appel suivant à get() renverra uniquement la première valeur username indexée :

js
formData.get("username"); // Renvoie "Chris"

Spécifications

Specification
XMLHttpRequest Standard
# dom-formdata-get

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi