Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

CookieChangeEvent

Baseline 2025
Neu verfügbar

Seit June 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

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 Ereignistyp des change-Events, das bei einem CookieStore ausgelöst wird, wenn ein Cookie erstellt oder gelöscht wird.

Hinweis: Ein Cookie, das aufgrund der Einfügung 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.

Instanz-Eigenschaften

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 Verfallsdatum in der Vergangenheit erstellt wurden, da diese sofort gelöscht werden.

CookieChangeEvent.deleted Schreibgeschützt

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

Instanz-Methoden

Diese Schnittstelle erbt auch Methoden von Event.

Beispiele

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

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

const oneDay = 24 * 60 * 60 * 1000;
cookieStore.set({
  name: "cookie1",
  value: "cookie1-value",
  expires: Date.now() + oneDay,
  domain: "example.com",
});

Spezifikationen

Spezifikation
Cookie Store API
# CookieChangeEvent

Browser-Kompatibilität