ExtendableCookieChangeEvent: changed-Eigenschaft
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: Dieses Feature ist nur verfügbar in Service Workers.
Die schreibgeschützte Eigenschaft changed
der Schnittstelle ExtendableCookieChangeEvent
gibt alle Cookies zurück, die durch die gegebene Instanz von ExtendableCookieChangeEvent
geändert wurden.
Wert
Ein Array von Objekten, das die geänderten Cookies enthält. 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 Third-Party-Websites initiiert werden.
"lax"
-
Cookies werden bei normalen Cross-Site-Unteranfragen (z. B. zum Laden von Bildern oder Frames auf einer Drittanbieter-Site) nicht gesendet, aber wenn ein Benutzer innerhalb der Ursprungssite navigiert (d. h. wenn er einem Link folgt), werden sie gesendet.
"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ängigem partitioniertem Status (CHIPS) für weitere Informationen.
Beispiele
In diesem Beispiel wird beim Setzen des Cookies der changed
Eigenschaft-Wert von dem Event-Listener in der Konsole protokolliert. Das erste Element in diesem Array enthält ein Objekt, das das gerade gesetzte Cookie repräsentiert.
self.addEventListener("cookiechange", (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-extendablecookiechangeevent-changed |
Browser-Kompatibilität
BCD tables only load in the browser