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: Diese Funktion ist nur in Service Workers verfügbar.
Die changed-Eigenschaft des ExtendableCookieChangeEvent-Interfaces gibt alle Cookies zurück, die durch die gegebene ExtendableCookieChangeEvent-Instanz verä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 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 Erstanbieterkontext gesendet und nicht mit Anfragen, die von Drittanbieter-Webseiten initiiert werden.
"lax"-
Cookies werden bei normalen Cross-Site-Subrequests (z. B. zum Laden von Bildern oder Frames in eine Drittanbieter-Seite) nicht gesendet, aber sie werden gesendet, wenn ein Benutzer innerhalb der Ursprungsseite 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). Weitere Informationen finden Sie unter Cookies mit unabhängiger partitionierter Zustandsverwaltung (CHIPS).
Beispiele
In diesem Beispiel wird beim Setzen des Cookies der Event-Listener die changed-Eigenschaft in die Konsole protokollieren. Das erste Element in diesem Array enthält ein Objekt, das das soeben gesetzte Cookie repräsentiert.
self.addEventListener("cookiechange", (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
| Specification |
|---|
| Cookie Store API # dom-extendablecookiechangeevent-changed |