cookies.OnChangedCause

OnChangedCause 类型是 cookies API 的一部分,用于表示 cookie 发生更改的原因。

类型

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

evicted

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

expired

由于过期,cookie 已被自动删除。

explicit

通过显式调用 cookies.remove() 插入或删除了 cookie。

expired_overwrite

cookie 已被具有已过期过期日期的 cookie 覆盖。

overwrite

调用 cookies.set() 将此 cookie 替换为另一个。

示例

您可以监听 cookies.onChanged 事件,以便在 cookie 发生更改时收到通知。监听器将接收一个 changeInfo 对象,其中包含一个 cause 属性,其值为 OnChangeCaused 字符串。

js
browser.cookies.onChanged.addListener((changeInfo) => {
  console.log(
    `Cookie changed: \n` +
      ` * Cookie: ${JSON.stringify(changeInfo.cookie)}\n` +
      ` * Cause: ${changeInfo.cause}\n` +
      ` * Removed: ${changeInfo.removed}`,
  );
});

浏览器兼容性

注意: 此 API 基于 Chromium 的 chrome.cookies API。本文档源自 Chromium 代码中的 cookies.json