CookieStore
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Dieses Feature ist verfügbar in Service Workers.
Die CookieStore
-Schnittstelle der Cookie Store API bietet Methoden zum asynchronen Abrufen und Setzen von Cookies, entweder von einer Seite oder einem Service Worker aus.
Der CookieStore
wird über Attribute im globalen Bereich in einem Window
oder ServiceWorkerGlobalScope
-Kontext aufgerufen. Daher gibt es keinen Konstruktor.
Instanzmethoden
-
Die
delete()
-Methode löscht ein Cookie mit dem angegebenenname
oderoptions
-Objekt. Sie gibt einPromise
zurück, das aufgelöst wird, wenn das Löschen abgeschlossen ist. -
Die
get()
-Methode erhält ein einzelnes Cookie mit dem angegebenenname
oderoptions
-Objekt. Sie gibt einPromise
zurück, das mit den Details eines einzelnen Cookies aufgelöst wird. -
Die
getAll()
-Methode erhält alle übereinstimmenden Cookies. Sie gibt einPromise
zurück, das mit einer Liste von Cookies aufgelöst wird. -
Die
set()
-Methode setzt ein Cookie mit dem angegebenenname
undvalue
oderoptions
-Objekt. Sie gibt einPromise
zurück, das aufgelöst wird, wenn das Cookie gesetzt ist.
Ereignisse
change
-
Das
change
-Ereignis wird ausgelöst, wenn eine Änderung an einem Cookie vorgenommen wird.
Beispiele
In diesem Beispiel setzen wir ein Cookie und schreiben eine Rückmeldung in die Konsole, ob der Vorgang erfolgreich war oder fehlgeschlagen ist.
const day = 24 * 60 * 60 * 1000;
cookieStore
.set({
name: "cookie1",
value: "cookie1-value",
expires: Date.now() + day,
domain: "example.com",
})
.then(
() => {
console.log("It worked!");
},
(reason) => {
console.error("It failed: ", reason);
},
);
Spezifikationen
Specification |
---|
Cookie Store API # CookieStore |
Browser-Kompatibilität
BCD tables only load in the browser