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

js
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 wie File) 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 oder File als zweiter Parameter übergeben wird. Der Standarddateiname für Blob Objekte ist "blob". Der Standarddateiname für File 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

js
formData.set("username", "Chris");

Wenn der Wert ein Blob (oder eine File) ist, können Sie seinen Namen mit dem filename-Parameter angeben:

js
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:

js
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

Siehe auch