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 : méthode get()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2018.

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

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

Syntaxe

js
get(name)

Paramètres

name

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

Valeur de retour

Une valeur dont la clé correspond au name défini. Sinon, null.

Exemples

Si nous ajoutons deux valeurs username à un FormData en utilisant append() :

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

La méthode get() suivante ne retourne que la première valeur username :

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

Spécifications

Spécification
XMLHttpRequest
# dom-formdata-get

Compatibilité des navigateurs

Voir aussi