Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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

js
formData()

Paramètres

Aucun.

Valeur de retour

Une promesse (Promise) qui se résout avec un objet FormData.

Exceptions

AbortError DOMException

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-Encoding est incorrect).
  • Le type MIME du corps ne peut pas être déterminé à partir des en‑têtes HTTP Content-Type inclus dans la réponse, ou n'est pas application/x-www-form-urlencoded ni multipart/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