The OnChangedCause
type of the cookies
API represents the reason a cookie changed.
On this page
cookies.OnChangedCause
Type
Values of this type are strings. Possible values are:
-
evicted
-
A cookie has been automatically removed due to garbage collection.
-
expired
-
A cookie has been automatically removed due to expiry.
-
explicit
-
A cookie has been inserted or removed via an explicit call to
cookies.remove()
. -
expired_overwrite
-
A cookie has been overwritten by a cookie with an already-expired expiration date.
-
overwrite
-
A call to
cookies.set()
overwrote this cookie with a different one.
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
OnChangedCause |
Yes | 79 | 45 | ? | Yes | No | ? | ? | 48 | ? | No | ? |
Examples
You can listen to the cookies.onChanged
event to be notified when cookies change. The listener is passed a changeInfo
object that contains a cause
property, whose value is the OnChangeCaused
string:
browser.cookies.onChanged.addListener((changeInfo) => {
console.log(`Cookie changed: \n`
+ ` * Cookie: ${JSON.stringify(changeInfo.cookie)}\n`
+ ` * Cause: ${changeInfo.cause}\n`
+ ` * Removed: ${changeInfo.removed}`);
});
Note: This API is based on Chromium's chrome.cookies
API. This documentation is derived from cookies.json
in the Chromium code.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/cookies/OnChangedCause