CookieStore: set()-Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Service Workers verfügbar.
Die set()
-Methode des CookieStore
-Interfaces setzt ein Cookie mit dem angegebenen name
und value
oder einem options
-Objekt.
Syntax
set(name, value)
set(options)
Parameter
Diese Methode erfordert eines der folgenden:
name
Optional-
Ein String mit dem Namen des Cookies.
value
Optional-
Ein String mit dem Wert des Cookies.
Oder
options
Optional-
Ein Objekt, das enthält:
domain
Optional-
Ein String, der die Domain des Cookies enthält. Standardmäßig
null
. expires
Optional-
Ein Zeitstempel, angegeben als Unix-Zeit in Millisekunden, der das Ablaufdatum des Cookies enthält. Standardmäßig
null
. name
-
Ein String mit dem Namen eines Cookies.
partitioned
Optional-
Ein boolescher Wert, der standardmäßig
false
ist. Wenn auftrue
gesetzt, wird das gesetzte Cookie ein partitioniertes Cookie sein. Weitere Informationen finden Sie unter Cookies Having Independent Partitioned State (CHIPS). path
Optional-
Ein String, der den Pfad des Cookies enthält. Standardmäßig
/
. sameSite
Optional-
Einer der folgenden
SameSite
Werte:"strict"
-
Cookies werden nur in einem First-Party-Kontext gesendet und nicht zusammen mit Anfragen, die von Drittwebsites initiiert werden. Dies ist der Standard.
"lax"
-
Cookies werden bei normalen Cross-Site-Unteranfragen (zum Beispiel zum Laden von Bildern oder Frames in eine Drittwebsite) nicht gesendet, aber wenn ein Benutzer zur Ursprungswebsite navigiert (d.h. wenn er einem Link folgt).
"none"
-
Cookies werden in allen Kontexten gesendet.
value
-
Ein String mit dem Wert des Cookies.
Rückgabewert
Ausnahmen
SecurityError
DOMException
-
Wird ausgelöst, wenn der Ursprung nicht zu einer URL serialisiert werden kann.
TypeError
-
Wird ausgelöst, wenn das Setzen des Cookies mit dem gegebenen
name
undvalue
oderoptions
fehlschlägt.
Beispiele
Das folgende Beispiel setzt ein Cookie, indem ein Objekt mit name
, value
, expires
und domain
übergeben wird.
const day = 24 * 60 * 60 * 1000;
cookieStore.set({
name: "cookie1",
value: "cookie1-value",
expires: Date.now() + day,
domain: "example.com",
});
Spezifikationen
Specification |
---|
Cookie Store API # dom-cookiestore-set |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
set | ||||||||||||
partitioned option |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support