blob: d5b08c1c1c8de0c11280fb4f547e4f7b4521672b (
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
|
---
title: FormData.get()
slug: Web/API/FormData/get
translation_of: Web/API/FormData/get
browser-compat: api.FormData.get
---
{{APIRef("XMLHttpRequest")}}
La méthode **`get()`** de l'interface [`FormData`](/fr/docs/Web/API/FormData) renvoie la première valeur associée à une clé donnée dans un objet `FormData`. Si vous souhaitez manipuler plusieurs valeurs et les récupérer intégralement, utilisez plutôt la méthode [`getAll()`](/fr/docs/Web/API/FormData/getAll).
> **Note :** Cette méthode est disponible dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API).
## Syntaxe
```js
formData.get(name);
```
### Paramètres
- `name`
- : Une chaîne de caractères [`USVString`](/fr/docs/Web/API/USVString) représentant le nom de la clé que vous souhaitez retrouver.
### Valeur de retour
Un objet [`FormDataEntryValue`](/fr/docs/Web/API/FormDataEntryValue) contenant la valeur. Si la clé n'existe pas, la méthode renvoie `null`.
## Exemple
La ligne suivante crée un objet `FormData` vide :
```js
var formData = new FormData();
```
Si nous ajoutons deux valeurs `username` en utilisant [`FormData.append`](/fr/docs/Web/API/FormData/append) :
```js
formData.append('username', 'Chris');
formData.append('username', 'Bob');
```
L'appel suivant à `get()` renverra uniquement la première valeur `username` indexée :
```js
formData.get('username'); // Renvoie "Chris"
```
## Spécifications
{{Specifications}}
## Compatibilité des navigateurs
{{Compat}}
## Voir aussi
- [`XMLHTTPRequest`](/fr/docs/Web/API/XMLHttpRequest)
- [Utiliser XMLHttpRequest](/fr/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest)
- [Utiliser les objets `FormData`](/fr/docs/Web/API/FormData/Using_FormData_Objects)
- [`<form>`](/fr/docs/Web/HTML/Element/Form)
|
