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

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 :

var formData = new FormData();

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

formData.append('username', 'Chris');
formData.append('username', 'Bob');

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

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

Spécifications

Specification
XMLHttpRequest Standard (XMLHttpRequest)
# dom-formdata-get

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi