Cookie Store API
CookieChangeEvent 接口的 changed 只读属性返回包含已被修改的 cookie 的数组。
请注意,这将排除那些创建的、过期时间在过去的 cookie,因为这些 cookie 会被立即删除。
值
包含被修改的 cookie 对象的数组。每个对象包含以下属性:
-
name- : 记录 cookie 名称的字符串。
-
value- : 记录 cookie 的值的字符串。
-
domain- : 记录 cookie 域名的字符串。
-
path- : 记录 cookie 路径的字符串。
-
expires- : Unix time(以毫秒为单位表示),记录 cookie 的到期日期。
-
secure- : 一个Boolean,表示 cookie 是否仅在安全上下文中使用(HTTPS 而不是 HTTP)。
-
sameSite- : 以下
SameSite的值之一:"strict"- : Cookie 只会在第一方上下文中发送,不会与第三方网站发起的请求一起发送。
"lax"- : Cookie 不会在正常的跨站点子请求(例如将图像或框架加载到第三方站点)中发送,而是在用户在原始站点内导航时发送(例如,点击链接时)。
"none"- : Cookie 将被发送至所有上下文。
- : 以下
-
partitioned- : 一个布尔值,表示 cookie 是否是分区 cookie(
true)或(false)。更多信息请参阅具有独立分区状态的 Cookie(CHIPS)。
- : 一个布尔值,表示 cookie 是否是分区 cookie(
示例
在以下示例中,当 cookie 被设置,事件监听器打印 CookieChangeEvent.changed 属性的第一个元素至控制台。这个元素代表刚刚设置的 cookie 对象。
cookieStore.addEventListener("change", (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",
});
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
