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 mit den folgenden Eigenschaften:

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 mit unabhängigem partitionierten Zustand (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 Erstparteikontext gesendet und nicht zusammen mit Anfragen, die von Drittanbieter-Websites initiiert werden. Dies ist der Standard.

"lax"

Cookies werden nicht bei normalen Cross-Site-Subanfragen gesendet (zum Beispiel zum Laden von Bildern oder Frames in eine Drittanbieter-Seite), jedoch gesendet, wenn ein Benutzer zur Ursprungsseite 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 angegebenen 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",
});