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

View in English Always switch to English

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 sowohl in Fenstern als auch in Service-Workern verfügbar ist.

Konzepte und Anwendung

Die ursprüngliche Methode zum Abrufen und Setzen von Cookies besteht darin, mit document.cookie zu arbeiten, um Cookie-Informationen als Zeichenkette von Schlüssel/Wert-Paaren zu erhalten und zu setzen. Zusätzlich zu dieser umständlichen und fehleranfälligen Methode gibt es in der modernen Webentwicklung eine Reihe von Problemen.

Die document.cookie-Schnittstelle ist synchron, single-threaded und blockierend. Beim Schreiben eines Cookies müssen Sie warten, bis der Browser die Zeichenkette aller Cookies aktualisiert hat. Darüber hinaus können Service-Worker aufgrund der Abhängigkeit von document nicht auf Cookies zugreifen, da sie nicht auf das document-Objekt zugreifen können.

Die Cookie Store API bietet eine aktualisierte Methode zum Verwalten von Cookies. Sie ist asynchron und basiert auf Promises, blockiert daher nicht die Ereignisschleife. Sie ist nicht auf Document angewiesen und steht somit Service-Workern zur Verfügung. Die Methoden zum Abrufen und Setzen von Cookies bieten auch mehr Rückmeldung in Form von Fehlermeldungen. Das bedeutet, dass Webentwickler nicht sofort ein Cookie setzen und dann zurücklesen müssen, um sicherzustellen, dass das Setzen erfolgreich war.

Schnittstellen

CookieStore Experimentell

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

CookieStoreManager Experimentell

Die CookieStoreManager-Schnittstelle bietet eine Service-Worker-Registrierung, um Service-Worker in die Lage zu versetzen, sich für Cookie-Änderungsereignisse anzumelden.

CookieChangeEvent Experimentell

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

ExtendableCookieChangeEvent

Ein ExtendableCookieChangeEvent mit dem Namen cookiechange wird in ServiceWorkerGlobalScope-Kontexten ausgelöst, wenn sichtbare Skript-Cookie-Änderungen auftreten, die mit der Cookie-Änderungsabonnementliste des Service-Workers übereinstimmen.

Erweiterungen zu anderen Schnittstellen

ServiceWorkerGlobalScope.cookieStore Schreibgeschützt Experimentell

Gibt einen Verweis auf das CookieStore-Objekt zurück, das dem Service-Worker zugeordnet ist.

ServiceWorkerRegistration.cookies Schreibgeschützt Experimentell

Gibt einen Verweis auf die CookieStoreManager-Schnittstelle zurück, die es einer Web-Anwendung ermöglicht, sich für Cookie-Änderungsereignisse an- und abzumelden.

Window.cookieStore Schreibgeschützt Experimentell

Gibt einen Verweis auf das CookieStore-Objekt für den aktuellen Dokumentkontext zurück.

cookiechange-Ereignis Experimentell

Wird ausgelöst, wenn Cookie-Änderungen aufgetreten sind, die mit der Cookie-Änderungsabonnementliste des Service-Workers übereinstimmen.

Spezifikationen

Specification
Cookie Store API

Browser-Kompatibilität

api.CookieStore

api.CookieStoreManager

Siehe auch