FormData

XMLHttpRequest Niveau 2 ajoute le support de la nouvelle interface FormData. Des objets formData fournissent un moyen facile de construire un ensemble de paires clé / valeur qui représentent les champs du formulaire et leurs valeurs, qui peuvent ensuite être facilement envoyés à l'aide de la méthode send () de l'objet XMLHttpRequest.

Il utilise le même format qu'utilise un formulaire si le type d'encodage est mis à "multipart / form-data".

Pour plus de détails sur la façon d'utiliser l'objet FormData, voir Utilisation des objets formData.

Constructeur

new FormData ([in HTMLFormElement form])

Paramètres

form
(facultatif) l'élement HTML <form> pour envoyer des clés / valeurs. Il permettra également d'encoder le contenu de l'input type file.

 

Aperçu de la méthode

void append(in DOMString name, in nsIVariant value);

Méthodes

append()

Ajoute une paire clé / valeur à l'objet FormData

void append(
  in DOMString name,
  in nsIVariant value
); 
Parameters
name
Le nom du champ dont les données sont contenues dans value.
value
La valeur du champ. Peut être un Blob, File, ou une chaîne de caractères, si aucun des deux, la valeur est convertie en une chaîne.
Notes

Si vous spécifiez un Blob comme données à ajouter à l'objet FormData, le nom du fichier qui sera transmis au serveur dans l'entête "Content-Disposition" varie d'un navigateur à l'autre. Voir le Compatibilité des navigateurs pour plus de détails.

Voir aussi

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
support basique 7+ 4.0 (2.0) 10+ 12+ 5+
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
support basique 3.0 4.0 (2.0) ?

12+

?

Gecko notes

Avant Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), si vous spécifiez un Blob comme données à ajouter à l'objet, le nom du fichier indiqué dans l'entête HTTP "Content-Disposition" est une chaîne vide, ce qui entraîne des erreurs signalés par certains serveurs. À partir de Gecko 7.0, le nom du fichier "blob" est envoyé.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : WSH, teoli, jdvauguet, maxpain2011
 Dernière mise à jour par : WSH,