Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

cookies.Cookie

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

Typ

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

domain

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

expirationDate Optional

Eine number, die das Ablaufdatum des Cookies als Sekunden nach dem UNIX-Epoch darstellt. Schließt Millisekunden im Bruchteil ein. Nicht für Sitzungscookies angegeben.

firstPartyDomain

Ein string, der die mit dem Cookie verbundene Erstpartei-Domain darstellt. Dies ist ein leerer String, wenn der Cookie gesetzt wurde, während die Isolation von Erstparteien ausgeschaltet war. Siehe Erstparteien-Isolation.

hostOnly

Ein boolean, true wenn der 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 der Cookie als HttpOnly markiert ist (d.h. der Cookie ist für clientseitige Skripte unzugänglich), oder false andernfalls.

name

Ein string, der den Namen des Cookies darstellt.

partitionKey Optional

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

topLevelSite

Ein string, der die Erstpartei-URL der Speicherpartition des Cookies darstellt, wenn der Cookie in einem nach Top-Level-Site partitionierten Speicher ist.

path

Ein string, der den Pfad des Cookies darstellt.

secure

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

session

Ein boolean, true wenn der Cookie ein Sitzungscookie ist, oder false wenn es ein persistenter Cookie mit Ablaufdatum ist.

sameSite

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

storeId

Ein string, der die ID des Cookie-Speichers darstellt, der diesen Cookie enthält, wie von cookies.getAllCookieStores() bereitgestellt.

value

Ein string, der den Wert des Cookies darstellt.

Beispiele

Die meisten Methoden der Cookies-API verwenden ein Cookie-Objekt als Eingabeparameter oder als Teil des Rückgabewertes. Beispielsweise gibt ein Aufruf von cookies.getAll() ein Array von Cookie-Objekten zurück.

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

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

Browser-Kompatibilität

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