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
。