CookieStore - 提供了从页面或服务工作线程异步获取和设置 Cookie 的方法

安全上下文
该功能仅在部分或所有支持的浏览器中的安全上下文(HTTPS)中可用。

CookieStoreCookie Store API 的接口,提供了从页面或服务工作线程异步获取和设置 Cookie 的方法。

可通过 WindowServiceWorkerGlobalScope 上下文中全局范围内的属性来访问 CookieStore。因此,其没有构造函数。

属性

事件处理程序

CookieStore.onChange

每当更改 cookie 时,都会调用 onchange 事件处理程序。

方法

CookieStore.delete()

delete() 方法删除具有给定名称或选项对象的 cookie,它返回一个 Promise,在删除完成时进行解析。

CookieStore.get()

get() 方法获取具有给定名称或选项对象的单个 cookie,它返回一个 Promise,解析为单个 cookie 的详细信息。

CookieStore.getAll()

getAll() 方法获取所有匹配的 cookie,它返回一个 Promise,解析为一个 cookie 列表。

CookieStore.set()

set() 方法使用给定的名称和值或选项对象设置 cookie,它返回一个 Promise,在设置完成时进行解析。

实例

在此实例中,我们设置一个 cookie 并将有关操作成功还是失败的反馈写入控制台。

const day = 24 * 60 * 60 * 1000;
cookieStore.set({
  name: "cookie1",
  value: "cookie1-value",
  expires: Date.now() + day,
  domain: "example.com"
})
.then(
  function() {
    console.log("设置成功!");
  },
  function(reason) {
    console.error("失败了:", reason);
  }
);

规范

规范 状态 备注
Unknown Unknown 初始定义。

桌面浏览器兼容性

暂无兼容数据