API хранилища куки

API хранилища куки — это асинхронный API для управления куками, доступный в окнах и также в рабочих процессах service workers.

Существующий метод получения и установки куки включает работу с document.cookie как с строкой пар ключ/значение. Помимо того, что это неудобно и подвержено ошибкам, это также имеет множество проблем в контексте современной разработки веб-приложений.

Интерфейс document.cookie является синхронным, однопоточным и блокирующим. При записи куки необходимо дождаться обновления браузером строки всех куки. Кроме того, зависимость от document означает, что куки недоступны для рабочих процессов service workers, которые не могут получить доступ к объекту document.

API хранилища куки предоставляет обновлённый способ управления куками. Он асинхронный и основан на промисах, поэтому не блокирует цикл событий. Он не полагается на document и поэтому доступен для рабочих процессов service workers. Методы получения и установки куки также предоставляют более подробную обратную связь в виде сообщений об ошибках. Это означает, что разработчики веб-приложений не должны устанавливать и сразу же считывать куки, чтобы проверить, была ли установка успешной.

CookieStore Экспериментальный

Интерфейс CookieStore позволяет получать и устанавливать куки.

CookieStoreManager Экспериментальный

Интерфейс CookieStoreManager предоставляет регистрацию рабочих процессов service workers для возможности подписки рабочих процессов service workers на события изменения куки.

CookieChangeEvent Экспериментальный

Событие CookieChangeEvent с именем change отправляется объектам CookieStore в контекстах Window при любых изменениях видимых куки.

ExtendableCookieChangeEvent

Событие ExtendableCookieChangeEvent с именем cookiechange отправляется в контекстах ServiceWorkerGlobalScope при любых изменениях видимых куки, которые соответствуют списку подписки рабочего процесса service worker на изменения куки.

ServiceWorkerGlobalScope.cookieStore Только для чтения Экспериментальный

Возвращает ссылку на объект CookieStore, связанный с рабочим процессом service worker.

ServiceWorkerRegistration.cookies Только для чтения Экспериментальный

Возвращает ссылку на интерфейс CookieStoreManager, который позволяет веб-приложению подписываться и отписываться от событий изменения куки.

Window.cookieStore Только для чтения Экспериментальный

Возвращает ссылку на объект CookieStore для текущего контекста документа.

cookiechange событие Экспериментальный

Срабатывает при любых изменениях куки, которые соответствуют списку подписки рабочего процесса service worker на изменения куки.

• API рабочих процессов Service Worker