CookieChangeEvent: Eigenschaft 'changed'

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.

Die schreibgeschützte Eigenschaft changed des CookieChangeEvent-Interfaces gibt ein Array der Cookies zurück, die geändert wurden.

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 verwendet wird (HTTPS statt HTTP).

sameSite

Einer der folgenden SameSite-Werte:

"strict"

Cookies werden nur im Erstanbieterkontext gesendet und nicht mit Anfragen, die von Drittanbieter-Websites initiiert werden.

"lax"

Cookies werden bei normalen Cross-Site-Subanfragen nicht gesendet (zum Beispiel zum Laden von Bildern oder Frames in eine Drittanbieter-Site), 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). Siehe Cookies Having Independent Partitioned State (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 darstellt.

js
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

Browser-Kompatibilität

BCD tables only load in the browser