CookieChangeEvent:changed 属性
Baseline 2025Newly available
Since June 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
CookieChangeEvent
接口的 changed
只读属性返回包含已被修改的 cookie 的数组。
请注意,这将排除那些创建的、过期时间在过去的 cookie,因为这些 cookie 会被立即删除。
值
包含被修改的 cookie 对象的数组。每个对象包含以下属性:
name
-
记录 cookie 名称的字符串。
value
-
记录 cookie 的值的字符串。
domain
-
记录 cookie 域名的字符串。
path
-
记录 cookie 路径的字符串。
expires
-
Unix 时间戳(以毫秒为单位表示),记录 cookie 的到期日期。
secure
-
一个布尔值,表示 cookie 是否仅在安全上下文中使用(HTTPS 而不是 HTTP)。
sameSite
-
以下
SameSite
的值之一: partitioned
-
一个布尔值,表示 cookie 是否是分区 cookie(
true
)或(false
)。更多信息请参阅具有独立分区状态的 Cookie(CHIPS)。
示例
在以下示例中,当 cookie 被设置,事件监听器打印 CookieChangeEvent.changed
属性的第一个元素至控制台。这个元素代表刚刚设置的 cookie 对象。
js
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",
});
规范
Specification |
---|
Cookie Store API # dom-cookiechangeevent-changed |