FormData

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.

L'interface FormData permet de construire facilement un ensemble de paires clé/valeur représentant les champs du formulaire et leurs valeurs, qui peuvent ensuite être facilement envoyées en utilisant la méthode XMLHttpRequest.send() de l'objet XMLHttpRequest. Elle utilise le même format qu'utilise un formulaire si le type d'encodage est mis à "multipart/form-data".

Vous pouvez également le passer directement au constructeur URLSearchParams si vous souhaitez générer des paramètres de requête de la même manière qu'un <form> le ferait s'il utilisait une simple soumission GET.

Un objet implémentant FormData peut être utilisé directement dans une structure for…of, au lieu de entries() : for (var p of myFormData) est équivalent à for (var p of myFormData.entries()).

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

Constructeur

FormData()

Crée un nouvel objet FormData.

Méthodes

FormData.append()

Ajoute une nouvelle valeur à une clé existante dans un objet FormData, ou ajoute la clé si elle n'existe pas encore.

FormData.delete()

Supprime une paire clé/valeur d'un objet FormData.

FormData.entries()

Renvoie un itérateur permettant de passer en revue toutes les paires clé/valeur contenues dans cet objet.

FormData.get()

Renvoie la première valeur associée à une clé donnée à partir d'un objet FormData.

FormData.getAll()

Renvoie un tableau de toutes les valeurs associées à une clé donnée à partir d'un objet FormData.

FormData.has()

Renvoie un booléen indiquant si un objet FormData contient une certaine clé.

FormData.keys()

Renvoie un itérateur permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet.

FormData.set()

Définit une nouvelle valeur pour une clé existante dans un objet FormData, ou ajoute la clé/valeur si elle n'existe pas encore.

FormData.values()

Renvoie un itérateur permettant de parcourir toutes les valeurs contenues dans cet objet.

Spécifications

Specification
XMLHttpRequest Standard
# interface-formdata

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi