CookieStoreManager: метод subscribe()

Метод subscribe() интерфейса CookieStoreManager подписывает ServiceWorkerRegistration на события изменения куки.

subscriptions

Массив объектов, каждый из которых имеет следующие свойства:

name

Строка с именем куки.

url

Строка с URL области действия куки. Она может быть ужесточена по сравнению с областью действия регистрации service worker.

Обещание Promise, которое разрешается со значением undefined при завершении подписки.

TypeError

Выбрасывается, если URL, переданный в subscriptions, не соответствует scope регистрации service worker.

В этом примере ServiceWorkerRegistration, представленный как registration, подписывается на события изменения куки с именем "cookie1" и областью действия "/path1".

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

URL, переданный методу subscribe(), может быть ужесточён по сравнению с областью действия регистрации service worker. В следующем примере подписка относится к /path/one/, поэтому она будет получать события изменения только для первого куки, но не для второго.

registration.cookies.subscribe([{ name: "cookie1", url: "/path/one/" }]); // subscription
cookieStore.set({ name: "cookie1", value: "cookie-value", path: "/path/one/" }); // receives a change event
cookieStore.set({ name: "cookie1", value: "cookie-value", path: "/path/two/" }); // does not receive a change event