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.

* Some parts of this feature may have varying levels of support.

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
# interface-formdata

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
FormData
[Symbol.iterator]
FormData() constructor
submitter parameter
append
filename parameter
delete
entries
forEach
get
getAll
has
keys
set
values
Available in workers

Legend

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

Full support
Full support
No support
No support
See implementation notes.

Voir aussi