The CookieStore
type of the cookies
API represents a cookie store in the browser.
Windows in different browsing modes may use different cookie stores — a private browsing/incognito mode window, for instance, will use a separate cookie store from a non-incognito/private window.
Values of this type are objects, which can contain the following properties:
id
string
representing the unique identifier for the cookie store.incognito
tabIds
array
of integers
, which identifies all of the browser tabs that share this cookie store.Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
CookieStore |
Yes |
14 |
45 |
? |
Yes |
14 |
? |
? |
48 |
? |
? |
? |
In the following snippet, the cookies.getAllCookieStores()
method is used to retrieve all the cookie stores currently available in the browser, and print out each cookie store ID, and the tabs that currently share each cookie store.
function logStores(cookieStores) { for(store of cookieStores) { console.log(`Cookie store: ${store.id}\n Tab IDs: ${store.tabIds}`); } } var getting = browser.cookies.getAllCookieStores(); getting.then(logStores);
The following code snippet gets all cookie stores and then logs the total number of stores and how many of those stores are incognito.
browser.cookies.getAllCookieStores().then((stores) => { var incognitoStores = stores.map(store => store.incognito); console.log(`Of ${stores.length} cookie stores, ${incognitoStores.length} are incognito.`); });
Note: This API is based on Chromium's chrome.cookies
API. This documentation is derived from cookies.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
© 2005–2021 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/CookieStore