CookieChangeEvent: changed-Eigenschaft
Baseline
2025
Neu verfügbar
Seit June 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die schreibgeschützte changed-Eigenschaft des CookieChangeEvent-Interfaces gibt ein Array der geänderten Cookies zurück.
Beachten Sie, dass dies Cookies ausschließt, die mit einem Ablaufdatum in der Vergangenheit erstellt wurden, da diese Cookies sofort gelöscht werden.
Wert
Ein Array von Objekten, die das/die geänderte(n) 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 Domain 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 statt 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 werden, gesendet.
"lax"-
Cookies werden bei normalen Cross-Site-Subrequests (z.B. um Bilder oder Frames in eine Drittanbieter-Website zu laden) nicht gesendet, aber sie werden gesendet, wenn ein Nutzer innerhalb der Ursprungssite navigiert (d.h. beim Folgen eines Links).
"none"-
Cookies werden in allen Kontexten gesendet.
partitioned-
Ein Boolean, der angibt, ob das Cookie ein partitioniertes Cookie (
true) ist oder nicht (false). Siehe Cookies mit unabhängiger partitionierter Zustände (CHIPS) für weitere Informationen.
Beispiele
In diesem Beispiel protokolliert der Event-Listener die changed-Eigenschaft in der Konsole, wenn das Cookie gesetzt wird. Das erste Element in diesem Array enthält ein Objekt, das das gerade gesetzte Cookie repräsentiert.
cookieStore.addEventListener("change", (event) => {
console.log(event.changed[0]);
});
const oneDay = 24 * 60 * 60 * 1000;
cookieStore.set({
name: "cookie1",
value: "cookie1-value",
expires: Date.now() + oneDay,
domain: "example.com",
});
Spezifikationen
| Spezifikation |
|---|
| Cookie Store API # dom-cookiechangeevent-changed |