cookies.OnChangedCause

cookies API 的 OnChangedCause 类型表示 cookie 更改的原因。

类型

此类型的值是字符串。可能的值有:

evicted

由于垃圾回收,cookie 被自动移除。

expired

由于过期,cookie 被自动移除。

explicit

插入了一个 cookie,或者通过显式调用 cookies.remove() 将一个 cookie 移除。

expired_overwrite

一个 cookie 被另一个已过期的 cookie 覆盖。

overwrite

调用 cookies.set() 用另一个 Cookie 覆盖了这个 Cookie。

浏览器兼容性

示例

你可以监听 cookies.onChanged 事件,以便在 cookie 更改时收到通知。监听器接收一个包含 cause 属性(其值为 OnChangedCause 字符串)的 changeInfo 对象:

js
browser.cookies.onChanged.addListener((changeInfo) => {
  console.log(
    `cookie 发生了变化:\n` +
      ` * cookie:${JSON.stringify(changeInfo.cookie)}\n` +
      ` * 变化原因:${changeInfo.cause}\n` +
      ` * 是否移除:${changeInfo.removed}`,
  );
});

备注: 此 API 基于 Chromium 的 chrome.cookies API。该文档衍生自 Chromium 代码中的 cookies.json