cookies.OnChangedCause

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

类型

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

evicted

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

expired

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

explicit

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

expired_overwrite

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

overwrite

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

浏览器兼容性

BCD tables only load in the browser

示例

你可以监听 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