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

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

• XMLHttpRequest
• Utilisation de XMLHttpRequest
• Utilisation des objects FormData
• form
• Spécification W3C

Compatibilité des navigateurs

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é.