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

Cookie Store API

· 52CE 我爱测

Cookie Store API** 是一个用于管理 cookies 的异步 API,可在 window 和 Service Worker 中使用。

Cookie Store APIwindow_and_service

Cookie Store API 是一个用于管理 cookies 的异步 API,可在 window 和 Service Worker 中使用。

概念和用法

现存的获取和设置的 cookies 的方法包括将 document.cookie 作为键/值对字符串使用。除了麻烦且容易出错之外,在现代网络开发的背景下它也存在许多问题。

document.cookie 接口是synchronous、单线程和阻塞的。编写 cookie 时,你必须等待浏览器更新包含所有 cookies 的字符串。此外,依赖 document 意味着访问不到 document 对象的 Service Worker 无法访问 cookie。

Cookie Store API 提供了管理 Cookie 更新的方法。方法是asynchronous和基于 Promise 的,因此不会阻塞事件循环。方法不依赖于 document,所以对于 Service Worker 也有效。获取和设置 cookie 的方法还通过错误消息提供了更多反馈。这意味着 Web 开发人员不必设置后,立即读取 cookie 来检查是否成功设置。

接口

  • CookieStore
    • : CookieStore 接口允许获取和设置 cookies。
  • CookieStoreManager
    • : CookieStoreManager 接口提供了 Service Worker Registration 用于允许 Service Worker 订阅 cookie 变更事件。
  • CookieChangeEvent
    • : 在 Window 上下文中发生任何脚本可见的 cookie 更改时,CookieStore 对象会派发出名为 change 的 CookieChangeEvent 事件。
  • ExtendableCookieChangeEvent
    • : 在 ServiceWorkerGlobalScope 上下文中发生任何脚本可见的 cookie 更改时,ExtendableCookieChangeEvent 将被派发,事件名为 cookiechange。

对其他接口的扩展

  • ServiceWorkerGlobalScope.cookieStore
    • : 返回此 Service Worker 关联的 CookieStore 对象的引用。
  • ServiceWorkerRegistration.cookies
    • : 返回 CookieStoreManager 接口的引用,它允许 Web APP 订阅和取消订阅 cookie 变更事件。
  • Window.cookieStore
    • : 返回当前 document 上下文的 CookieStore 对象。
  • ServiceWorkerGlobalScope/cookiechange_event 事件
    • : 当 cookie 发生任何更改时触发,与 Service Worker 的 Cookie 更改订阅列表相匹配。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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