cookies.CookieStore

Der CookieStore-Typ der cookies API repräsentiert einen Cookie-Speicher im Browser.

Fenster in verschiedenen Browsermodi können unterschiedliche Cookie-Speicher verwenden. Zum Beispiel verwendet ein Fenster im privaten Modus (oder Inkognito-Modus) einen separaten Cookie-Speicher als ein Nicht-Privat-Fenster. Außerdem kann ein Fenster in Firefox mehrere Cookie-Speicher haben, wenn Container-Tabs verwendet werden.

Siehe Arbeiten mit der Cookies-API für weitere Informationen über Cookie-Speicher.

Typ

Werte dieses Typs sind Objekte, die diese Eigenschaften enthalten können:

id

Ein string, der die eindeutige Kennung des Cookie-Speichers enthält.

incognito Optional

Ein boolescher Wert, der angibt, ob es sich um einen Inkognito-Cookie-Speicher handelt. Diese Eigenschaft wird in Chrome oder Safari nicht unterstützt. Allerdings können Sie Inkognito-Cookie-Speicher in Chrome erkennen, da ihre id immer "1" ist.

tabIds

Ein array von integers, das alle Browser-Tabs identifiziert, die diesen Cookie-Speicher teilen.

Beispiele

In diesem Beispiel wird die Methode cookies.getAllCookieStores() verwendet, um alle im Browser verfügbaren Cookie-Speicher abzurufen. Dann werden die jeweiligen Cookie-Speicher-IDs und die Tabs, die jeden Cookie-Speicher teilen, ausgegeben.

js
function logStores(cookieStores) {
  for (const store of cookieStores) {
    console.log(`Cookie store: ${store.id}\n Tab IDs: ${store.tabIds}`);
  }
}

browser.cookies.getAllCookieStores().then(logStores);

Dieses Codebeispiel ruft alle Cookie-Speicher ab und protokolliert dann die Gesamtanzahl der Speicher sowie wie viele dieser Speicher Inkognito sind.

js
browser.cookies.getAllCookieStores().then((stores) => {
  const incognitoStores = stores.map((store) => store.incognito);
  console.log(
    `Of ${stores.length} cookie stores, ${incognitoStores.length} are incognito.`,
  );
});

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf der Chromium-API chrome.cookies. Diese Dokumentation ist abgeleitet von cookies.json im Chromium-Code.