CookieChangeEvent

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

CookieChangeEventCookie Store API 的接口,是 change 事件的事件类型,当任何 cookie 被创建或删除时,该事件会在 CookieStore 上触发。

注意:由于插入了具有相同名称、域和路径的另一个 cookie,而被替换的 cookie 将被忽略,不会触发更改事件。

Event CookieChangeEvent

构造函数

CookieChangeEvent()

创建一个新的 CookieChangeEvent

实例属性

此接口还继承了 Event 的属性。

CookieChangeEvent.changed 只读

一个数组,列出所有新创建的 cookie。注意,这将排除以过去时间为过期日期创建的 cookie,因为这些 cookie 会立即被删除。

CookieChangeEvent.deleted 只读

一个数组,列出所有被删除的 cookie,无论是由于过期还是由于显式删除。注意,这将包括以过去时间为过期日期创建的 cookie。

实例方法

此接口还继承了 Event 的方法。

示例

在此示例中,当设置 cookie 时,事件监听器将事件记录到控制台。这是一个 CookieChangeEvent 对象,其 changed 属性包含一个表示刚刚设置的 cookie 的对象。

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

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
# CookieChangeEvent

浏览器兼容性

BCD 表格仅在浏览器中加载