CookieStoreManager: unsubscribe()-Methode

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

Die unsubscribe()-Methode der CookieStoreManager-Schnittstelle stoppt die ServiceWorkerRegistration von der Empfangnahme zuvor abonnierter Ereignisse.

Syntax

js
unsubscribe(subscriptions)

Parameter

subscriptions

Eine Objektliste, wobei jedes Objekt folgende Daten enthält:

name

Ein String mit dem Namen eines Cookies.

url

Ein String mit der URL des Bereichs, der zum Abonnieren dieses Cookies verwendet wurde.

Rückgabewert

Ein Promise, der sich mit undefined auflöst, wenn der Service Worker abgemeldet wurde.

Ausnahmen

TypeError

Wird ausgelöst, wenn die in subscriptions übergebene URL nicht mit dem scope der Service Worker-Registrierung übereinstimmt.

Beispiele

In diesem Beispiel meldet sich die durch registration repräsentierte ServiceWorkerRegistration von Änderungsereignissen auf dem Cookie namens "cookie1" mit einem Bereich von "/path1" ab.

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

Spezifikationen

Specification
Cookie Store API
# dom-cookiestoremanager-unsubscribe

Browser-Kompatibilität

BCD tables only load in the browser