blob: 12b77b0afa27496f241bfd366472f7670a6e6c44 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
---
title: FormData
slug: Web/API/FormData
tags:
- API
- FormData
- Interface
- Reference
- XMLHttpRequest
translation_of: Web/API/FormData
---
{{APIRef("XMLHttpRequest")}}
L'interface `FormData` permet de construire facilement un ensemble de paires clé/valeur représentant les champs du formulaire et leurs valeurs, qui peuvent ensuite être facilement envoyées en utilisant la méthode {{domxref("XMLHttpRequest.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"`.
Vous pouvez également le passer directement au constructeur {{domxref("URLSearchParams")}} si vous souhaitez générer des paramètres de requête de la même manière qu'un {{HTMLElement("form")}} le ferait s'il utilisait une simple soumission `GET`.
Un objet implémentant `FormData` peut être utilisé directement dans une structure {{jsxref("Statements/for...of", "for...of")}}, au lieu de {{domxref('FormData.entries()', 'entries()')}} : `for (var p of myFormData)` est équivalent à `for (var p of myFormData.entries())`.
> **Note :** Cette fonctionnalité est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API).
## Constructeur
- {{domxref("FormData.FormData","FormData()")}}
- : Crée un nouvel objet `FormData`.
## Méthodes
- {{domxref("FormData.append()")}}
- : Ajoute une nouvelle valeur à une clé existante dans un objet `FormData`, ou ajoute la clé si elle n'existe pas encore.
- {{domxref("FormData.delete()")}}
- : Supprime une paire clé/valeur d'un objet `FormData`.
- {{domxref("FormData.entries()")}}
- : Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de passer en revue toutes les paires clé/valeur contenues dans cet objet.
- {{domxref("FormData.get()")}}
- : Renvoie la première valeur associée à une clé donnée à partir d'un objet `FormData`.
- {{domxref("FormData.getAll()")}}
- : Retourne un tableau de toutes les valeurs associées à une clé donnée à partir d'un `FormData`.
- {{domxref("FormData.has()")}}
- : Renvoie un booléen indiquant si un objet `FormData` contient une certaine clé.
- {{domxref("FormData.keys()")}}
- : Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet.
- {{domxref("FormData.set()")}}
- : Définit une nouvelle valeur pour une clé existante dans un objet `FormData`, ou ajoute la clé/valeur si elle n'existe pas encore.
- {{domxref("FormData.values()")}}
- : Retourne une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet.
## Spécifications
| Spécification | Statut | Commentaire |
| ------------------------------------------------------------------------------------ | ------------------------------------ | ----------------------------------- |
| {{SpecName('XMLHttpRequest','#interface-formdata','FormData')}} | {{Spec2('XMLHttpRequest')}} | FormData définit dans les specs XHR |
## Compatibilité des navigateurs
{{Compat("api.FormData")}}
## Voir aussi
- {{domxref("XMLHTTPRequest")}}
- [Utilisation de XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest)
- [Utilisation des objects FormData](/fr/docs/Web/API/FormData/Utilisation_objets_FormData)
- {{HTMLElement("Form")}}
|
