FormData: set() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die set()
Methode der FormData
-Schnittstelle setzt einen neuen Wert für einen bestehenden Schlüssel in einem FormData
-Objekt oder fügt den Schlüssel/Wert hinzu, wenn dieser noch nicht existiert.
Der Unterschied zwischen set()
und append()
besteht darin, dass set()
alle vorhandenen Werte durch den neuen Wert ersetzt, wenn der angegebene Schlüssel bereits existiert, während append()
den neuen Wert an die bestehende Menge von Werten anhängt.
Syntax
set(name, value)
set(name, value, filename)
Parameter
name
-
Der Name des Feldes, dessen Daten in
value
enthalten sind. value
-
Der Wert des Feldes. Dies kann ein String oder ein
Blob
(einschließlich Unterklassen wieFile
) sein. Wenn keines davon angegeben ist, wird der Wert in einen String umgewandelt. filename
Optional-
Der an den Server gemeldete Dateiname (ein String), wenn ein
Blob
oderFile
als zweiter Parameter übergeben wird. Der Standarddateiname fürBlob
Objekte ist "blob". Der Standarddateiname fürFile
Objekte ist der Dateiname der Datei.
Hinweis: Wenn Sie ein Blob
als die Daten angeben, die dem FormData
-Objekt hinzugefügt werden sollen, variierte der Dateiname, der im Header "Content-Disposition" an den Server gemeldet wird, von Browser zu Browser.
Rückgabewert
Keiner (undefined
).
Beispiele
formData.set("username", "Chris");
Wenn der Wert ein Blob
(oder eine File
) ist, können Sie seinen Namen mit dem filename
-Parameter angeben:
formData.set("user-pic", myFileInput.files[0], "chris.jpg");
Wenn der Wert kein String oder Blob
ist, wird set()
ihn automatisch in einen String umwandeln:
formData.set("name", 72);
formData.get("name"); // "72"
Spezifikationen
Specification |
---|
XMLHttpRequest Standard # dom-formdata-set |
Browser-Kompatibilität
BCD tables only load in the browser