Baseline Widely available
Note : Cette fonctionnalité est disponible via les Web Workers.
La méthode set()
de l'interface 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 FormData.append
est que si la clé spécifiée existe déjà , set()
écrasera toutes les valeurs existantes avec la nouvelle, tandis que FormData.append
ajoutera la nouvelle valeur à la fin de l'ensemble de valeurs existant.
Note : Cette méthode est disponible dans les Web Workers.
SyntaxeIl 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);
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 USVString
ou d'un Blob
(y compris les sous-classes telles que File
). Si aucune de ces sous-classes n'est spécifiée, la valeur est convertie en une chaîne de caractères.
filename
Facultatif
Le nom de fichier communiqué au serveur (un USVString
), lorsqu'un Blob
ou un File
est passée comme deuxième paramètre. Le nom de fichier par défaut pour les objets Blob
est "blob". Le nom de fichier par défaut pour les objets File
est le nom du fichier.
Note : Si vous spécifiez un 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.
La ligne suivante crée un objet FormData
vide:
var formData = new FormData(); // Actuellement vide
Vous pouvez définir des paires clé/valeur à ce sujet en utilisant FormData.set
:
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
:
formData.set("name", 72);
formData.get("name"); // "72"
Spécifications Compatibilité des navigateurs Voir aussi
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4