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), oderfalse
andernfalls. httpOnly
-
Ein
boolean
,true
wenn das Cookie als HttpOnly markiert ist (d.h. das Cookie ist für clientseitige Skripte nicht zugänglich), oderfalse
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), oderfalse
andernfalls. session
-
Ein
boolean
,true
wenn das Cookie ein Sitzungscookie ist, oderfalse
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 durchcookies.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:
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.