Cookie Store API

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Service Workers verfügbar.

Die Cookie Store API ist eine asynchrone API zum Verwalten von Cookies, die in Fenstern und auch in Service-Workern verfügbar ist.

Konzepte und Verwendung

Die bestehende Methode zum Abrufen und Setzen von Cookies umfasst die Arbeit mit document.cookie als Zeichenfolge von Schlüssel/Wert-Paaren. Neben der Tatsache, dass dies umständlich und fehleranfällig ist, gibt es auch eine Reihe von Problemen im Kontext der modernen Webentwicklung.

Die Schnittstelle document.cookie ist synchron, single-threaded und blockierend. Beim Schreiben eines Cookies müssen Sie warten, bis der Browser die Zeichenfolge aller Cookies aktualisiert hat. Zudem bedeutet die Abhängigkeit von document, dass Cookies von Service-Workern, die nicht auf das document-Objekt zugreifen können, nicht erreicht werden können.

Die Cookie Store API bietet eine aktualisierte Methode zum Verwalten von Cookies. Sie ist asynchron und basiert auf Versprechen, sodass sie die Ereignisschleife nicht blockiert. Sie ist unabhängig von document und steht daher Service-Workern zur Verfügung. Die Methoden zum Abrufen und Setzen von Cookies bieten außerdem durch Fehlermeldungen mehr Feedback. Dies bedeutet, dass Webentwickler nicht ein Cookie setzen und dann sofort zurücklesen müssen, um zu überprüfen, ob das Setzen erfolgreich war.

Schnittstellen

CookieStore Experimentell

Die Schnittstelle CookieStore ermöglicht das Abrufen und Setzen von Cookies.

CookieStoreManager Experimentell

Die Schnittstelle CookieStoreManager bietet eine Registrierung für Service-Worker, um ihnen zu ermöglichen, sich für Ereignisse zu Cookie-Änderungen zu registrieren.

CookieChangeEvent Experimentell

Ein CookieChangeEvent mit dem Namen change wird gegen CookieStore-Objekte in Window-Kontexten ausgelöst, wenn skript-sichtbare Cookie-Änderungen auftreten.

ExtendableCookieChangeEvent

Ein ExtendableCookieChangeEvent mit dem Namen cookiechange wird in ServiceWorkerGlobalScope-Kontexten ausgelöst, wenn skript-sichtbare Cookie-Änderungen auftreten, die der Cookie-Änderungs-Abonnementliste des Service-Workers entsprechen.

Erweiterungen zu anderen Schnittstellen

ServiceWorkerGlobalScope.cookieStore Schreibgeschützt Experimentell

Gibt eine Referenz auf das mit dem Service-Worker verbundene CookieStore-Objekt zurück.

ServiceWorkerRegistration.cookies Schreibgeschützt Experimentell

Gibt eine Referenz auf die Schnittstelle CookieStoreManager zurück, die es einer Web-App ermöglicht, sich für Cookie-Änderungsereignisse zu registrieren und diese abzubestellen.

Window.cookieStore Schreibgeschützt Experimentell

Gibt eine Referenz auf das CookieStore-Objekt für den aktuellen Dokumentkontext zurück.

cookiechange Ereignis Experimentell

Wird ausgelöst, wenn Cookie-Änderungen aufgetreten sind, die der Cookie-Änderungs-Abonnementliste des Service-Workers entsprechen.

Spezifikationen

Specification
Cookie Store API

Browser-Kompatibilität

api.CookieStore

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
CookieStore
change event
delete
partitioned option
get
domain in return value
expires in return value
name in return value
partitioned in return value
Experimental
path in return value
sameSite in return value
secure in return value
value in return value
getAll
domain in return value
expires in return value
name in return value
partitioned in return value
Experimental
path in return value
sameSite in return value
secure in return value
value in return value
set
partitioned option

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.

api.CookieStoreManager

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
CookieStoreManager
getSubscriptions
subscribe
unsubscribe

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch