FormData.append()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Note : Cette fonctionnalité est disponible via les Web Workers.
La méthode append() de l'interface FormData ajoute une nouvelle valeur à une clé existante dans un objet FormData, ou rajoute cette clé et cette valeur quand elle n'existe pas.
La différence entre FormData.set et append() est que, quand la clé existe, FormData.set va remplacer les valeurs existantes avec la nouvelle alors qu' append() va rajouter celle-ci à la fin de l'ensemble des valeurs existantes.
Note : Cette méthode est disponible dans les Web Workers.
Syntaxe
Il y a deux versions de cette méthode : avec deux ou trois paramètres
formData.append(name, value);
formData.append(name, value, filename);
Paramètres
name-
Le nom de la clé dont les données sont contenues dans
value. value-
La valeur du champ clé. Elle peut être une
USVStringou unBlob(incluant les sous-classes commeFile). filenameFacultatif-
Le nom du fichier envoyé au serveur (a
USVString), quand unBlobou unFileest passé en second paramètre. Le nom du fichier par défaut pour des objetsBlobest "blob". Le nom du fichier par défaut pour des objetsFileest le nom du fichier de l'objet.
Note :
Si vous spécifiez un Blob comme donnée rattachée à un objet de type FormData, le nom de fichier envoyé au serveur sera dans l'entête "Content-Disposition" mais peut varier selon le navigateur.
Retours
Void.
Exemple
La ligne suivante crée un objet FormData vide :
var formData = new FormData(); // Actuellement vide
Vous pouvez rajouter des paires clé/valeur en utilisant FormData.append:
formData.append("username", "Chris");
formData.append("userpic", myFileInput.files[0], "chris.jpg");
Comme pour un formulaire classique, vous pouvez ajouter plusieurs valeurs pour la même clé. Par exemple ( et pour être en accord avec les conventions de nommage PHP, on ajoute [] au nom de la clé):
formData.append("userpic[]", myFileInput.files[0], "chris1.jpg");
formData.append("userpic[]", myFileInput.files[1], "chris2.jpg");
Cette technique permet de simplement gérer l'envoi de plusieurs fichiers avec l'envoi d'une structure facilement itérable.
Spécifications
| Specification |
|---|
| XMLHttpRequest # dom-formdata-append |
Compatibilité des navigateurs
Chargement…