cookies.Cookie

Typ

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

domain

Ein string, der die Domain repräsentiert, zu der das Cookie gehört (z.B. "www.google.com" oder "example.com").

expirationDate Optional

Eine number, die das Ablaufdatum des Cookies als Anzahl der Sekunden seit dem UNIX-Epoch darstellt. Nicht vorhanden bei Session-Cookies.

firstPartyDomain

Ein string, der die mit dem Cookie assoziierte First-Party-Domain repräsentiert. Dies ist ein leerer String, wenn das Cookie gesetzt wurde, während die First-Party-Isolation deaktiviert war. Siehe First-party isolation.

hostOnly

Ein boolean, true, wenn es sich bei dem Cookie um ein host-only Cookie handelt (d.h. der Host der Anfrage muss genau mit der Domain des Cookies übereinstimmen), oder false andernfalls.

httpOnly

Ein boolean, true, wenn das Cookie als HttpOnly markiert ist (d.h. das Cookie ist für clientseitige Skripte nicht zugänglich), oder false andernfalls.

name

Ein string, der den Namen des Cookies repräsentiert.

partitionKey Optional

Ein object, das die Beschreibung der storage partition enthält, in der sich das Cookie befindet. Dieses Objekt wird weggelassen (null), wenn das Cookie nicht in partitioniertem Speicher ist. Dieses Objekt enthält die folgenden Eigenschaften:

topLevelSite

Ein string, der die First-Party-URL der Speicherpartition des Cookies repräsentiert, falls das Cookie in einem nach Top-Level-Site partitionierten Speicher ist.

path

Ein string, der den Pfad des Cookies repräsentiert.

secure

Ein boolean, true, wenn das Cookie als sicher markiert ist (d.h. sein Geltungsbereich ist auf sichere Kanäle, typischerweise HTTPS, beschränkt), oder false andernfalls.

session

Ein boolean, true, wenn das Cookie ein Session-Cookie ist, oder false, wenn es sich um ein persistentes Cookie mit einem Ablaufdatum handelt.

sameSite

Ein cookies.SameSiteStatus-Wert, der den SameSite-Status des Cookies angibt.

storeId

Ein string, der die ID des Cookie-Speichers repräsentiert, der dieses Cookie enthält, wie sie von cookies.getAllCookieStores() bereitgestellt wird.

value

Ein string, der den Wert des Cookies repräsentiert.

Beispiele

Die meisten Methoden der Cookies-API beinhalten ein Cookie-Objekt als Eingabeparameter oder als Teil des Rückgabewerts. Ein Aufruf von cookies.getAll() gibt zum Beispiel ein Array von Cookie-Objekten zurück.

Dieses Beispiel fragt nach allen Cookies und protokolliert dann einige der Werte aus jedem der resultierenden Cookie-Objekte:

function logCookies(cookies) {
  for (cookie of cookies) {
    console.log(`Domain: ${cookie.domain}`);
    console.log(`Name: ${cookie.name}`);
    console.log(`Value: ${cookie.value}`);
    console.log(`Persistent: ${!cookie.session}`);
  }
}

let gettingAll = browser.cookies.getAll({});
gettingAll.then(logCookies);

Browser-Kompatibilität