大网数据广告活动
Web 标准与前端开发

CookieStoreManager:subscribe() 方法

· 52CE 我爱测

CookieStoreManager 接口的 **`subscribe()`** 方法订阅 ServiceWorkerRegistration 的 cookie 更改事件。

Cookie Store APIwindow_and_service

CookieStoreManager 接口的 subscribe() 方法订阅 ServiceWorkerRegistration 的 cookie 更改事件。

语法

subscribe(subscriptions)

参数

  • subscriptions
    • : 一个对象列表,每个对象包括以下属性:
      • name
        • : 记录 cookie 名称的字符串。
      • url
        • : 记录 cookie URL 作用域的字符串。可能比 Service Worker Registration 的作用域更小。

返回值

订阅成功时兑现为 undefined 的 Promise。

异常

  • TypeError
    • : 如果传入的 URL 不匹配 Service Worker Registration 的ServiceWorkerRegistration.scope,则抛出该异常。

示例

在此示例中,由 registration 表示的 ServiceWorkerRegistration 订阅了 "/path1" 作用域下命名为 "cookie1" 的 cookie 的变更事件。

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

传给 subscribe() 方法的 URL 可能比 Service Worker Registration 的作用域更小。以下示例订阅是针对 /path/one/ 的,所以只会接收到第一个 cookie 的变更事件,而第二个收不到。

registration.cookies.subscribe([{ name: "cookie1", url: "/path/one/" }]); // 订阅 cookie1
cookieStore.set({ name: "cookie1", value: "cookie-value", path: "/path/one/" }); // 收到一个变更事件
cookieStore.set({ name: "cookie1", value: "cookie-value", path: "/path/two/" }); // 不会受到变更事件

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。