CookieStore

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

备注： 此特性在 Web Worker 中可用。

Cookie Store API 的 CookieStore 接口提供了在页面或 Service Worker 中异步设置和获取 cookies 的方法

CookieStore 通过 Window 或 ServiceWorkerGlobalScope 上下文的全局范围内的属性进行访问。因此，不存在构造函数。

实例方法

CookieStore.delete(): delete() 方法通过 name 或 options 对象删除 cookie，返回一个删除完成后兑现的 Promise。
CookieStore.get(): get() 方法获通过 name 或 options 对象获取一个 cookie，返回一个兑现为 cookie 详细信息的 Promise。
CookieStore.getAll(): getAll() 方法获取所有匹配的 cookie，返回一个兑现为 cookie 列表的 Promise。
CookieStore.set(): set() 方法通过给定的 name 和 value 或 options 对象设置 cookie，返回一个设置成功后兑现的 Promise。

事件

change: 当 cookie 发生任何变更将触发 change 事件。

示例

在此示例中，我们设置了一个 cookie，并将其写入控制台以了解该操作是成功还是失败。

const day = 24 * 60 * 60 * 1000;

cookieStore
  .set({
    name: "cookie1",
    value: "cookie1-value",
    expires: Date.now() + day,
    domain: "example.com",
  })
  .then(
    () => {
      console.log("成功了！");
    },
    (reason) => {
      console.error("设置失败：", reason);
    },
  );

规范

Specification
Cookie Store API # CookieStore

浏览器兼容性

BCD tables only load in the browser