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), oderfalse
andernfalls. httpOnly
-
Ein
boolean
,true
wenn der Cookie als HttpOnly markiert ist (d.h. der Cookie ist für clientseitige Skripte unzugänglich), oderfalse
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), oderfalse
andernfalls. session
-
Ein
boolean
,true
wenn der Cookie ein Sitzungscookie ist, oderfalse
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 voncookies.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:
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
Loading…
Hinweis:
Diese API basiert auf der chrome.cookies
API von Chromium. Diese Dokumentation ist von cookies.json
im Chromium-Code abgeleitet.