CookieStore: set()-Methode

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 auf true 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.

Ein Promise, das mit undefined aufgelöst wird, wenn das Setzen des Cookies abgeschlossen ist.

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 und value oder options fehlschlägt.

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",
});