Response : 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 Response lit un flux de must be provided jusqu'à son terme. Elle retourne une promesse qui est résolue avec un objet FormData.
Note :
Ceci est principalement pertinent pour les service workers. Si un·e utilisateur·ice soumet un formulaire et qu'un service worker intercepte la requête, vous pouvez par exemple appeler formData() dessus pour obtenir une table clé-valeur, modifier certains champs, puis envoyer le formulaire au serveur (ou l'utiliser localement).
Syntaxe
formData()
Paramètres
Aucun.
Valeur de retour
Une promesse (Promise) qui se résout avec un objet FormData.
Exceptions
AbortErrorDOMException-
La requête a été annulée.
TypeError-
Levée pour l'une des raisons suivantes :
- Le corps de la réponse est perturbé ou verrouillé.
- Une erreur est survenue lors du décodage du contenu du corps (par exemple parce que l'en-tête HTTP
Content-Encodingest incorrect). - Le type MIME du corps ne peut pas être déterminé à partir des en‑têtes HTTP
Content-Typeinclus dans la réponse, ou n'est pasapplication/x-www-form-urlencodednimultipart/form-data. - Le corps ne peut pas être analysé en tant qu'objet
FormData.
Spécifications
| Specification |
|---|
| Fetch> # ref-for-dom-body-formdata①> |
Compatibilité des navigateurs
Voir aussi
- L'API ServiceWorker
- Contrôle d'accès HTTP (CORS)
- La référence HTTP