cookies.CookieStore
Der Typ CookieStore
der cookies
API repräsentiert einen Cookie-Speicher im Browser.
Fenster in verschiedenen Browsing-Modi können unterschiedliche Cookie-Speicher verwenden. Ein Beispiel ist der private Browsing-/Inkognito-Modus, der einen separaten Cookie-Speicher von einem Nicht-Inkognito-/privaten Fenster verwendet. Außerdem kann ein Fenster mehrere Cookie-Speicher verwenden, wenn man Container-Tabs in Firefox nutzt.
Siehe Arbeiten mit der Cookies API für weitere Informationen über Cookie-Speicher.
Typ
Werte dieses Typs sind Objekte, die folgende Eigenschaften enthalten können:
id
-
Ein
string
, der den eindeutigen Bezeichner für den Cookie-Speicher darstellt. incognito
Optional-
Ein boolescher Wert, der anzeigt, ob es sich um einen Inkognito-Cookie-Speicher handelt. Diese Eigenschaft wird in Chrome oder Safari nicht unterstützt. Sie können jedoch Inkognito-Cookie-Speicher in Chrome identifizieren, da deren
id
immer "1" ist. tabIds
-
Ein
array
vonintegers
, das alle Browser-Tabs identifiziert, die diesen Cookie-Speicher teilen.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Im folgenden Snippet wird die Methode cookies.getAllCookieStores()
verwendet, um alle momentan im Browser verfügbaren Cookie-Speicher abzurufen und die ID jedes Cookie-Speichers sowie die Tabs, die derzeit jeden Cookie-Speicher teilen, auszugeben.
function logStores(cookieStores) {
for (const store of cookieStores) {
console.log(`Cookie store: ${store.id}\n Tab IDs: ${store.tabIds}`);
}
}
browser.cookies.getAllCookieStores().then(logStores);
Das folgende Code-Snippet erfasst alle Cookie-Speicher und protokolliert dann die Gesamtzahl der Speicher und wie viele dieser Speicher Inkognito sind.
browser.cookies.getAllCookieStores().then((stores) => {
const incognitoStores = stores.map((store) => store.incognito);
console.log(
`Of ${stores.length} cookie stores, ${incognitoStores.length} are incognito.`,
);
});
Hinweis: Diese API basiert auf der Chromium-API chrome.cookies
. Diese Dokumentation ist abgeleitet von cookies.json
im Chromium-Code.