From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/formdata/set/index.md | 101 ++++++++++++++------------------- 1 file changed, 44 insertions(+), 57 deletions(-) (limited to 'files/fr/web/api/formdata/set') diff --git a/files/fr/web/api/formdata/set/index.md b/files/fr/web/api/formdata/set/index.md index 2174a28c4d..3df31fa9a8 100644 --- a/files/fr/web/api/formdata/set/index.md +++ b/files/fr/web/api/formdata/set/index.md @@ -11,82 +11,69 @@ tags: - set translation_of: Web/API/FormData/set --- -

{{APIRef("XMLHttpRequest")}}

+{{APIRef("XMLHttpRequest")}} -

La méthode set() de l'interface {{domxref("FormData")}} définit une nouvelle valeur pour une clé existante dans un objet FormData, ou ajoute la clé/valeur si elle n'existe pas encore.

+La méthode `set()` de l'interface {{domxref("FormData")}} définit une nouvelle valeur pour une clé existante dans un objet `FormData`, ou ajoute la clé/valeur si elle n'existe pas encore. -

La différence entre set() et {{domxref("FormData.append")}} est que si la clé spécifiée existe déjà, set() écrasera toutes les valeurs existantes avec la nouvelle, tandis que {{domxref("FormData.append")}} ajoutera la nouvelle valeur à la fin de l'ensemble de valeurs existant.

+La différence entre `set()` et {{domxref("FormData.append")}} est que si la clé spécifiée existe déjà, `set()` écrasera toutes les valeurs existantes avec la nouvelle, tandis que {{domxref("FormData.append")}} ajoutera la nouvelle valeur à la fin de l'ensemble de valeurs existant. -
-

Note : Cette méthode est disponible dans les Web Workers.

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

Syntaxe

+## Syntaxe -

Il existe deux versions de cette méthode : une version à deux et une version à trois paramètres :

+Il existe deux versions de cette méthode : une version à deux et une version à trois paramètres : -
formData.set(name, value);
-formData.set(name, value, filename);
+```js +formData.set(name, value); +formData.set(name, value, filename); +``` -

Paramètres

+#### Paramètres -
-
name
-
Le nom du champ dont les données sont contenues en valeur (value).
-
value
-
La valeur du champ. Il peut s'agir d'un {{domxref("USVString")}} ou d'un {{domxref("Blob")}} (y compris les sous-classes telles que {{domxref("File")}}). Si aucune de ces sous-classes n'est spécifiée, la valeur est convertie en une chaîne de caractères.
-
filename {{optional_inline}}
-
Le nom de fichier communiqué au serveur (un {{domxref("USVString")}}), lorsqu'un {{domxref("Blob")}} ou un {{domxref("File")}} est passée comme deuxième paramètre. Le nom de fichier par défaut pour les objets {{domxref("Blob")}} est "blob". Le nom de fichier par défaut pour les objets {{domxref("File")}} est le nom du fichier.
-
+- `name` + - : Le nom du champ dont les données sont contenues en valeur (`value`). +- `value` + - : La valeur du champ. Il peut s'agir d'un {{domxref("USVString")}} ou d'un {{domxref("Blob")}} (y compris les sous-classes telles que {{domxref("File")}}). Si aucune de ces sous-classes n'est spécifiée, la valeur est convertie en une chaîne de caractères. +- `filename `{{optional_inline}} + - : Le nom de fichier communiqué au serveur (un {{domxref("USVString")}}), lorsqu'un {{domxref("Blob")}} ou un {{domxref("File")}} est passée comme deuxième paramètre. Le nom de fichier par défaut pour les objets {{domxref("Blob")}} est "blob". Le nom de fichier par défaut pour les objets {{domxref("File")}} est le nom du fichier. -
-

Note : Si vous spécifiez un {{domxref("Blob")}} comme donnée à ajouter à l'objet FormData, le nom du fichier qui sera rapporté au serveur dans l'en-tête "Content-Disposition" utilisé pour varier d'un navigateur à l'autre.

-
+> **Note :** Si vous spécifiez un {{domxref("Blob")}} comme donnée à ajouter à l'objet FormData, le nom du fichier qui sera rapporté au serveur dans l'en-tête "Content-Disposition" utilisé pour varier d'un navigateur à l'autre. -

Exemple

+## Exemple -

La ligne suivante crée un objet FormData vide:

+La ligne suivante crée un objet `FormData` vide: -
var formData = new FormData(); // Actuellement vide
+```js +var formData = new FormData(); // Actuellement vide +``` -

Vous pouvez définir des paires clé/valeur à ce sujet en utilisant {{domxref("FormData.set")}} :

+Vous pouvez définir des paires clé/valeur à ce sujet en utilisant {{domxref("FormData.set")}} : -
formData.set('username', 'Chris');
-formData.set('userpic', myFileInput.files[0], 'chris.jpg');
+```js +formData.set('username', 'Chris'); +formData.set('userpic', myFileInput.files[0], 'chris.jpg'); +``` -

Si la valeur envoyée est différente de String ou Blob, elle sera automatiquement convertie en String :

+Si la valeur envoyée est différente de String ou Blob, elle sera automatiquement convertie en `String` : -
formData.set('name', 72);
-formData.get('name'); // "72"
+```js +formData.set('name', 72); +formData.get('name'); // "72" +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('XMLHttpRequest','#dom-formdata-set','set()')}}{{Spec2('XMLHttpRequest')}}
+| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------- | ------------------------------------ | ----------- | +| {{SpecName('XMLHttpRequest','#dom-formdata-set','set()')}} | {{Spec2('XMLHttpRequest')}} | | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs +{{Compat("api.FormData.set")}} +## Voir aussi -

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

- -

Voir aussi

- - +- {{domxref("XMLHTTPRequest")}} +- [Utiliser XMLHttpRequest](/fr/docs/Web/API/XMLHttpRequest/Utiliser_XMLHttpRequest) +- [Utiliser les objets FormData](/fr/docs/Web/Guide/Using_FormData_Objects) +- {{HTMLElement("Form")}} -- cgit v1.2.3-54-g00ecf