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 Oktober 2018.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
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
valueenthalten 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. filenameOptional-
Der an den Server gemeldete Dateiname (ein String), wenn ein
BloboderFileals zweiter Parameter übergeben wird. Der Standarddateiname fürBlobObjekte ist "blob". Der Standarddateiname fürFileObjekte 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 # dom-formdata-set |
Browser-Kompatibilität
Loading…