CookieStoreManager

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: Dieses Feature ist verfügbar in Service Workers.

Das CookieStoreManager Interface der Cookie Store API ermöglicht es Service-Workern, sich für Cookie-Änderungsereignisse zu registrieren. Rufen Sie subscribe() bei einer bestimmten Service-Worker-Registrierung auf, um Änderungsereignisse zu empfangen.

Ein CookieStoreManager ist mit einer ServiceWorkerRegistration assoziiert. Jede Service-Worker-Registrierung hat eine Liste von Cookie-Änderungsabonnements, die aus einem Namen und einer URL besteht. Die Methoden in diesem Interface ermöglichen es dem Service-Worker, Abonnements zu dieser Liste hinzuzufügen, daraus zu entfernen und eine Liste aller Abonnements abzurufen.

Um einen CookieStoreManager zu erhalten, rufen Sie ServiceWorkerRegistration.cookies auf.

Instanzmethoden

CookieStoreManager.getSubscriptions()

Gibt ein Promise zurück, das sich zu einer Liste von Cookie-Änderungsabonnements für diese Service-Worker-Registrierung auflöst.

CookieStoreManager.subscribe()

Abonniert Änderungen an Cookies. Es gibt ein Promise zurück, das sich auflöst, wenn das Abonnement erfolgreich ist.

CookieStoreManager.unsubscribe()

Hebt das Abonnement des registrierten Service-Workers für Änderungen an Cookies auf. Es gibt ein Promise zurück, das sich auflöst, wenn die Operation erfolgreich ist.

Beispiele

In diesem Beispiel abonniert die ServiceWorkerRegistration, die durch registration repräsentiert wird, Änderungsereignisse für das Cookie namens "cookie1" im Bereich "/path1".

js
const subscriptions = [{ name: "cookie1", url: `/path1` }];
await registration.cookies.subscribe(subscriptions);

Wenn die ServiceWorkerRegistration Cookies abonniert hat, gibt getSubscriptions() eine Liste von Cookies zurück, die durch Objekte im gleichen Format wie das ursprüngliche Abonnement repräsentiert werden.

js
const subscriptions = await self.registration.cookies.getSubscriptions();

Spezifikationen

Specification
Cookie Store API
# cookiestoremanager

Browser-Kompatibilität

BCD tables only load in the browser