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

ExtendableCookieChangeEvent

· 52CE 我爱测

Cookie Store API 的 **`ExtendableCookieChangeEvent`** 接口是传递给 ServiceWorkerGlobalScope/cookiechange_event 事件的事件类型,当发生任何与 service worker 的 cookie 更改订阅列表匹配的 cookie 更改时,该事件在 ServiceWorkerGlobalScope 上触发。cookie 更改事件由 cookie 和 type 组成。(“changed”或“deleted”)

Cookie Store APIservice

Cookie Store API 的 ExtendableCookieChangeEvent 接口是传递给 ServiceWorkerGlobalScope/cookiechange_event 事件的事件类型,当发生任何与 service worker 的 cookie 更改订阅列表匹配的 cookie 更改时,该事件在 ServiceWorkerGlobalScope 上触发。cookie 更改事件由 cookie 和 type 组成。(“changed”或“deleted”)

导致派发 ExtendableCookieChangeEvent 的 cookie 更改包括:

  • 新建一个 cookie,但不会立即删除。在这种情况下,type 为“changed”。
  • 新建一个 cookie,但会立即删除。在这种情况下,type 为“deleted”。
  • 删除一个 cookie。在这种情况下,type 为“deleted”。

[!NOTE] 由于插入另一个具有相同名称、域和路径的 cookie 而被替换的 cookie 将被忽略并且不会触发更改事件。

构造函数

  • ExtendableCookieChangeEvent.ExtendableCookieChangeEvent
    • : 创建一个新的 ExtendableCookieChangeEvent。

实例属性

此接口还从 ExtendableEvent 继承属性。

  • ExtendableCookieChangeEvent.changed
    • : 返回包含已更改的 cookie 的数组。
  • ExtendableCookieChangeEvent.deleted
    • : 返回包含已删除的 cookie 的数组。

实例方法

此接口还从 ExtendableEvent 继承方法。

示例

在以下示例中,我们使用 CookieStoreManager.getSubscriptions() 获取现有订阅的列表。(在 service worker 中,需要订阅才能监听事件。)我们使用 CookieStoreManager.unsubscribe() 取消订阅现有订阅,然后使用 CookieStoreManager.subscribe() 订阅名称为“COOKIE_NAME”的 cookie。如果该 cookie 发生更改,事件监听器会将该事件记录到控制台。这将是一个 ExtendableCookieChangeEvent 对象,其 ExtendableCookieChangeEvent.changed 或 ExtendableCookieChangeEvent.deleted 属性包含已修改的 cookie。

self.addEventListener("activate", (event) => {
  event.waitUntil(async () => {
    const subscriptions = await self.registration.cookies.getSubscriptions();

    await self.registration.cookies.unsubscribe(subscriptions);

    await self.registration.cookies.subscribe([
      {
        name: "COOKIE_NAME",
      },
    ]);
  });
});

self.addEventListener("cookiechange", (event) => {
  console.log(event);
});

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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