CookieChangeEvent: changed-Eigenschaft
Baseline 2025Newly available
Since June 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die schreibgeschützte changed
-Eigenschaft der CookieChangeEvent
-Schnittstelle gibt ein Array der Cookies zurück, die geändert wurden.
Beachten Sie, dass Cookies mit einem Ablaufdatum in der Vergangenheit ausgeschlossen werden, da diese Cookies sofort gelöscht werden.
Wert
Ein Array von Objekten, die die geänderten Cookie(s) enthalten. Jedes Objekt enthält die folgenden Eigenschaften:
name
-
Ein String, der den Namen des Cookies enthält.
value
-
Ein String, der den Wert des Cookies enthält.
domain
-
Ein String, der die Domäne des Cookies enthält.
path
-
Ein String, der den Pfad des Cookies enthält.
expires
-
Ein Zeitstempel, angegeben als Unix-Zeit in Millisekunden, der das Ablaufdatum des Cookies enthält.
secure
-
Ein
boolean
, der angibt, ob das Cookie nur in einem sicheren Kontext (HTTPS anstelle von HTTP) verwendet wird. sameSite
-
Einer der folgenden
SameSite
-Werte:"strict"
-
Cookies werden nur in einem First-Party-Kontext gesendet und nicht mit Anfragen, die von Drittanbieter-Websites initiiert wurden.
"lax"
-
Cookies werden nicht bei normalen Cross-Site-Unteranfragen gesendet (z.B. zum Laden von Bildern oder Frames in eine Drittanbieter-Website), aber sie werden gesendet, wenn ein Benutzer innerhalb der Ursprungsseite navigiert (d.h. wenn er einem Link folgt).
"none"
-
Cookies werden in allen Kontexten gesendet.
partitioned
-
Ein boolean, der angibt, ob das Cookie ein partitioniertes Cookie (
true
) ist oder nicht (false
). Weitere Informationen finden Sie unter Cookies Having Independent Partitioned State (CHIPS).
Beispiele
In diesem Beispiel, wenn das Cookie gesetzt wird, protokolliert der Event-Listener die changed
-Eigenschaft in die Konsole. Das erste Element in diesem Array enthält ein Objekt, das das gerade gesetzte Cookie darstellt.
cookieStore.addEventListener("change", (event) => {
console.log(event.changed[0]);
});
const one_day = 24 * 60 * 60 * 1000;
cookieStore.set({
name: "cookie1",
value: "cookie1-value",
expires: Date.now() + one_day,
domain: "example.com",
});
Spezifikationen
Specification |
---|
Cookie Store API # dom-cookiechangeevent-changed |