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 des CookieStoreManager-Interfaces stoppt die ServiceWorkerRegistration vom Empfang zuvor abonnierter Ereignisse.

Syntax

js
unsubscribe(subscriptions)

Parameter

subscriptions

Eine Liste von Objekten, wobei jedes Objekt enthält:

name

Einen String mit dem Namen eines Cookies.

url

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

Rückgabewert

Ein Promise, das mit undefined aufgelöst wird, wenn der Service Worker abgemeldet wurde.

Ausnahmen

TypeError

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

Beispiele

In diesem Beispiel meldet sich die durch registration repräsentierte ServiceWorkerRegistration von Änderungsereignissen beim Cookie mit dem Namen "cookie1" und 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