ExtendableCookieChangeEvent: 更改属性

安全上下文:此功能仅在 安全上下文 (HTTPS) 中可用,在某些或所有 支持的浏览器 中可用。

注意:此功能仅在 Service Workers 中可用。

changed 属性是 ExtendableCookieChangeEvent 接口的只读属性,它返回由给定 ExtendableCookieChangeEvent 实例更改的任何 cookie。

包含已更改 cookie 的对象数组。每个对象都包含以下属性

名称

包含 cookie 名称的字符串。

包含 cookie 值的字符串。

包含 cookie 域的字符串。

路径

包含 cookie 路径的字符串。

过期时间

时间戳,以毫秒为单位的 Unix 时间,包含 cookie 的过期日期。

安全

一个 boolean,指示 cookie 是否仅在安全上下文 (HTTPS 而不是 HTTP) 中使用。

sameSite

以下 SameSite 值之一

"严格"

Cookie 仅在第一方上下文中发送,不会随第三方网站发起的请求一起发送。

"宽松"

Cookie 不会在正常的跨站点子请求中发送(例如,将图像或框架加载到第三方网站),但会在用户在源网站内导航时发送(即,在遵循链接时)。

"无"

Cookie 将在所有上下文中发送。

分区

一个布尔值,指示 cookie 是否为分区 cookie (true) 还是否 (false)。有关更多信息,请参阅 具有独立分区状态的 Cookie (CHIPS)

示例

在此示例中,当设置 cookie 时,事件侦听器将 changed 属性记录到控制台。该数组中的第一个项目包含一个表示刚刚设置的 cookie 的对象。

js
self.addEventListener("cookiechange", (event) => {
  console.log(event.changed[0]);
});

const one_day = 24 * 60 * 60 * 1000;
cookieStore.set({
  name: "cookie1",
  value: "cookie1-value",
  expires: Date.now() + one_day,
  domain: "example.com",
});

规范

规范
Cookie Store API
# dom-extendablecookiechangeevent-changed

浏览器兼容性

BCD 表仅在浏览器中加载