CookieStoreManager

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The CookieStoreManager interface of the Cookie Store API allows service workers to subscribe to events for cookie changes. By using the subscribe() method a particular service worker registration can indicate that it is interested in change events.

A CookieStoreManager has an associated ServiceWorkerRegistration. Each service worker registration has a cookie change subscription list, which is a list of cookie change subscriptions each containing a name and url. The methods in this interface allow the service worker to add and remove subscriptions from this list, and to get a list of all subscriptions.

To get a CookieStoreManager, call ServiceWorkerRegistration.cookies.

Methods

CookieStoreManager.getSubscriptions()

Returns a promise which resolves to a list of the cookie change subscriptions for this service worker registration.

CookieStoreManager.subscribe()

Subscribes to changes to cookies. It returns a promise which resolves when the subscription is successful.

CookieStoreManager.unsubscribe()

Unsubscribes the registered service worker from changes to cookies. It returns a promise which resolves when the operation is successful.

Examples

In this example the ServiceWorkerRegistration represented by registration is subscribing to change events on the cookie named "cookie1" with a scope of "/path1".

const subscriptions = [{ name: 'cookie1', url: `/path1` }];
await registration.cookies.subscribe(subscriptions);

If the ServiceWorkerRegistration has subscribed to any cookies then getSubscriptions() will return a list of cookies represented by objects in the same format as used for the original subscription.

const subscriptions = await registration.cookies.getSubscriptions();

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
CookieStoreManager
87
87
No
No
73
No
87
87
No
62
No
14.0
getSubscriptions
87
87
No
No
73
No
87
87
No
62
No
14.0
subscribe
87
87
No
No
73
No
87
87
No
62
No
14.0
unsubscribe
87
87
No
No
73
No
87
87
No
62
No
14.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CookieStoreManager