aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/formdata/keys/index.md
blob: e41b139f4b3f991100eecd1753de7e6d8ae8b67b (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.keys()
slug: Web/API/FormData/keys
tags:
  - API
  - FormData
  - Iteration
  - Méthode
  - Reference
  - XHR
  - XMLHttpRequestAPI
  - keys
translation_of: Web/API/FormData/keys
---
{{APIRef("XMLHttpRequest")}}

La méthode `FormData.keys()` renvoie une {{jsxref("Les_protocoles_iteration", "itération")}} permettant de parcourir toutes les clés contenues dans cet objet. Les clés sont des objets {{domxref("USVString")}}.

> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API).

## Syntaxe

    formData.keys();

### Valeur de retour

Retourne une {{jsxref("Les_protocoles_iteration", "itération")}}.

## Exemple

```js
// Créer un object FormData test
var formData = new FormData();
formData.append('cle1', 'valeur1');
formData.append('cle2', 'valeur2');

// Affiche les clés
for (var key of formData.keys()) {
   console.log(key);
}
```

Le résultat est :

    cle1
    cle2

## Spécifications

| Spécification                                                                                            | Statut                               | Commentaire         |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------- |
| {{SpecName('XMLHttpRequest','#dom-formdata','keys() (as iterator<>)')}} | {{Spec2('XMLHttpRequest')}} | Définition initiale |

## Compatibilité des navigateurs

{{Compat("api.FormData.keys")}}

## Voir aussi

- {{domxref("XMLHTTPRequest")}}
- [Utiliser XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest)
- [Utiliser les objets FormData](/fr/docs/Web/API/FormData/Utilisation_objets_FormData)
- {{HTMLElement("Form")}}