cookies.Cookie

Der Cookie-Typ der cookies API repräsentiert Informationen über ein HTTP-Cookie.

Typ

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

domain

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

expirationDate Optional

Eine number, die das Ablaufdatum des Cookies als Anzahl der Sekunden seit dem UNIX-Epoch darstellt. Nicht angegeben für Sitzungscookies.

firstPartyDomain

Ein string, der die zugehörige First-Party-Domain des Cookies repräsentiert. Dies wird ein leerer String sein, wenn das Cookie gesetzt wurde, während die First-Party-Isolation ausgeschaltet war. Siehe First-party-Isolation.

hostOnly

Ein boolean, true wenn das Cookie ein Host-only-Cookie ist (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 Speicherpartition enthält, die das Cookie enthält. Dieses Objekt wird ausgelassen (null), wenn das Cookie nicht in einem partitionierten Speicher ist. Dieses Objekt enthält die folgenden Eigenschaften:

topLevelSite

Ein string, der die First-Party-URL der Speicherpartition des Cookies darstellt, wenn 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 Sitzungscookie ist, oder false wenn es ein persistentes Cookie mit einem Ablaufdatum ist.

sameSite

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

storeId

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

value

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

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Die meisten Methoden in der cookies API beinhalten ein Cookie-Objekt, das entweder als Eingabeparameter verwendet wird oder als Teil des Rückgabewerts. Zum Beispiel liefert ein Aufruf von cookies.getAll() ein Array von Cookie-Objekten.

Im folgenden Beispiel haben wir alle Cookies abgefragt und einige der Werte von jedem der resultierenden Cookie-Objekte protokolliert:

js
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);

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