CookieStoreManager: unsubscribe() method

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

注意:此功能在 Service Workers 中可用。

CookieStoreManager 介面的 unsubscribe() 方法會阻止 ServiceWorkerRegistration 接收先前已訂閱的事件。

語法

js
unsubscribe(subscriptions)

引數

subscriptions

一個物件列表,每個物件包含:

name

一個包含 cookie 名稱的字串。

url

用於訂閱此 cookie 的範圍的 URL 字串。

返回值

當 service worker 取消訂閱時,解析為 undefinedPromise

異常

TypeError

如果 subscriptions 中傳入的 URL 與 service worker 註冊的 scope 不匹配,則會丟擲此錯誤。

示例

在此示例中,由 registration 表示的 ServiceWorkerRegistration 正在取消訂閱範圍為 "/path1" 的名為 "cookie1" 的 cookie 上的更改事件。

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

規範

規範
Cookie Store API
# dom-cookiestoremanager-unsubscribe

瀏覽器相容性