CookieChangeEvent:已删除属性

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

CookieChangeEvent 接口的deleted 只读属性返回一个数组,其中包含由给定 CookieChangeEvent 实例删除的 cookie。

请注意,这将包括使用过去的过期日期创建的 cookie,因为这些 cookie 会立即删除。

价值

包含已删除 cookie 的对象数组。每个对象包含以下属性

名称

包含 cookie 名称的字符串。

价值

包含 cookie 值的字符串。

领域

包含 cookie 域的字符串。

路径

包含 cookie 路径的字符串。

到期

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

安全

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

sameSite

以下SameSite 值之一

"严格"

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

"宽松"

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

"无"

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

分区

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

示例

在此示例中,当 cookie 被删除时,事件侦听器会将 CookieChangeEvent.deleted 属性中的第一个项目记录到控制台中。它包含一个表示刚刚删除的 cookie 的对象。

js
cookieStore.addEventListener("change", (event) => {
  console.log(event.deleted[0]);
});

规范

规范
Cookie Store API
# dom-cookiechangeevent-deleted

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。