Request : méthode formData()
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 avril 2021.
Note : Cette fonctionnalité est disponible via les Web Workers.
La méthode formData() de l'interface Request lit le corps de la requête et le retourne sous la forme d'une promesse qui se résout avec un objet FormData.
Syntaxe
js
formData()
Paramètres
Aucun.
Valeur de retour
Une promesse (Promise) qui se résout avec un objet FormData.
Exceptions
TypeError-
Levée pour l'une des raisons suivantes :
- Le corps de la requête est perturbé ou verrouillé.
- Une erreur s'est produite lors du décodage du contenu du corps (par exemple, parce que l'en-tête
Content-Encodingest incorrect). - Le type MIME du corps ne peut pas être déterminé à partir des en-têtes
Content-Typeinclus dans la requête, ou n'est pasapplication/x-www-form-urlencodedoumultipart/form-data. - Le corps ne peut pas être analysé comme un objet
FormData.
Exemples
js
const donneesFormulaire = new FormData();
const champFichier = document.querySelector('input[type="file"]');
donneesFormulaire.append("username", "abc123");
donneesFormulaire.append("avatar", champFichier.files[0]);
const requete = new Request("/myEndpoint", {
method: "POST",
body: donneesFormulaire,
});
requete.formData().then((donnees) => {
// faire quelque chose avec les données du formulaire envoyées dans la requête
});
Spécifications
| Specification |
|---|
| Fetch # ref-for-dom-body-formdata① |
Compatibilité des navigateurs
Voir aussi
- La méthode
Response.formData()