CookieChangeEvent

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 CookieChangeEvent-Schnittstelle der Cookie Store API ist der Eventtyp des change-Ereignisses, das an einem CookieStore ausgelöst wird, wenn Cookies erstellt oder gelöscht werden.

Hinweis: Ein Cookie, das durch das Einfügen eines anderen Cookies mit demselben Namen, derselben Domain und demselben Pfad ersetzt wird, wird ignoriert und löst kein Änderungsereignis aus.

Event CookieChangeEvent

Konstruktor

CookieChangeEvent()

Erstellt ein neues CookieChangeEvent.

Instanzeigenschaften

Diese Schnittstelle erbt auch Eigenschaften von Event.

CookieChangeEvent.changed Schreibgeschützt

Ein Array, das alle neu erstellten Cookies auflistet. Beachten Sie, dass dies Cookies ausschließt, die mit einem Ablaufdatum in der Vergangenheit erstellt wurden, da diese Cookies sofort gelöscht werden.

CookieChangeEvent.deleted Schreibgeschützt

Ein Array, das alle Cookies auflistet, die entweder abgelaufen sind oder explizit gelöscht wurden. Beachten Sie, dass dies Cookies einschließt, die mit einem Ablaufdatum in der Vergangenheit erstellt wurden.

Instanzmethoden

Diese Schnittstelle erbt auch Methoden von Event.

Beispiele

In diesem Beispiel, wenn das Cookie gesetzt wird, protokolliert der Event-Listener das Ereignis in die Konsole. Dies ist ein CookieChangeEvent-Objekt mit der changed-Eigenschaft, die ein Objekt enthält, das das gerade gesetzte Cookie repräsentiert.

js
cookieStore.addEventListener("change", (event) => {
  console.log(event);
});

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
# CookieChangeEvent

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
CookieChangeEvent
CookieChangeEvent() constructor
changed
domain property
expires property
name property
partitioned property
Experimental
path property
sameSite property
secure property
value property
deleted
domain property
expires property
name property
partitioned property
Experimental
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
Experimental. Expect behavior to change in the future.