cookies.OnChangedCause

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

类型

此类型的值为字符串。可能的取值有

evicted

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

expired

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

explicit

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

expired_overwrite

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

overwrite

调用cookies.set()用不同的 cookie 覆盖了此 cookie。

浏览器兼容性

BCD 表仅在浏览器中加载

示例

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