CookieChangeEvent: 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.

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

Beachten Sie, dass dies Cookies ausschließt, die mit einem Verfallsdatum 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 Domäne des Cookies enthält.

path

Ein String, der den Pfad des Cookies enthält.

expires

Ein Zeitstempel, angegeben in 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 wurden.

"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 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 Zustands (CHIPS).

Beispiele

In diesem Beispiel wird, wenn das Cookie gesetzt ist, der Event-Listener die changed-Eigenschaft in die Konsole protokollieren. Das erste Element in diesem Array enthält ein Objekt, das das gerade gesetzte Cookie repräsentiert.

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
changed
domain property
expires property
name property
partitioned property
path property
sameSite property
secure property
value property

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support