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 schreibgeschützte changed-Eigenschaft des ExtendableCookieChangeEvent-Interfaces gibt alle Cookies zurück, die durch die gegebene Instanz des ExtendableCookieChangeEvent-Objekts verändert wurden.

Wert

Ein Array von Objekten, das die veränderten Cookies enthält. Jedes Objekt besitzt 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 anzeigt, 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-Websites initiiert wurden.

"lax"

Cookies werden bei normalen Cross-Site-Subanfragen (zum Beispiel beim Laden von Bildern oder Frames auf einer Drittanbieterseite) nicht gesendet, jedoch gesendet, wenn ein Benutzer innerhalb der Ursprungsseite navigiert (z.B. 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 Having Independent Partitioned State (CHIPS).

Beispiele

In diesem Beispiel, wenn das Cookie gesetzt wird, protokolliert der Ereignis-Listener die changed-Eigenschaft in der Konsole. Das erste Element in diesem Array enthält ein Objekt, das das gerade gesetzte Cookie darstellt.

js
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