Cookie Store API

Baseline 2025 *

Newly available

Since June 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Want more support for this feature? Tell us why.

* Some parts of this feature may have varying levels of support.

보안 컨텍스트: 이 기능은 일부 또는 모든 지원 브라우저의 보안 컨텍스트 (HTTPS)에서만 사용할 수 있습니다.

참고 : 이 기능은 Web Worker에서 사용할 수 있습니다.

Cookie Store API는 쿠키를 관리하는 비동기 API로서, windows와 서비스 워커에서 사용 가능합니다.

개념 및 사용법

쿠키를 가져오고 설정하는 기존 방법 중에는 키/값 쌍의 문자열로 document.cookie를 사용하는 것이 있습니다. 이는 번거롭고 오류가 발생하기 쉬울 뿐만 아니라 최신 웹 개발의 맥락에서 여러 가지 문제가 있습니다.

document.cookie 인터페이스는 synchronous, 단일 스레드, 블로킹 방식입니다. 쿠키를 작성할 때 브라우저가 모든 쿠키의 문자열을 업데이트할 때까지 기다려야 합니다. 또한 document에 의존한다는 것은 document 객체에 접근할 수 없는 서비스 워커가 쿠키에 접근할 수 없음을 의미합니다.

Cookie Store API는 향상된 쿠키 관리 방법을 제공합니다. asynchronous이며 프로미스 기반이므로 이벤트 루프를 차단하지 않습니다. document에 의존하지 않으므로 서비스 워커가 사용할 수 있습니다. 또한 쿠키를 가져오고 설정하는 메서드는 오류 메시지를 통해 더 많은 피드백을 제공합니다. 즉, 웹 개발자는 설정이 성공했는지 확인하기 위해 쿠키를 설정한 다음 즉시 쿠키를 다시 읽을 필요가 없습니다.

인터페이스

CookieStore: CookieStore 인터페이스를 통해 쿠키를 가져오고 설정할 수 있습니다.
CookieStoreManager: CookieStoreManager 인터페이스는 서비스 워커가 쿠키 변경 이벤트를 구독할 수 있도록 서비스 워커 등록을 제공합니다.
CookieChangeEvent: script-visible 쿠키가 변경될 때 Window 컨텍스트의 CookieStore 객체에 대해 change이라는 이름의 CookieChangeEvent가 전송됩니다.
ExtendableCookieChangeEvent: 서비스 워커의 쿠키 변경 구독 목록에 있는 script-visible 쿠키의 변경이 발생하면 cookiechange라는 이름의 ExtendableCookieChangeEvent가 ServiceWorkerGlobalScope 컨텍스트에서 디스패치됩니다.

다른 인터페이스로의 확장

ServiceWorkerGlobalScope.cookieStore 읽기 전용: 서비스 워커와 연관된 CookieStore 객체에 대한 참조를 반환합니다.
ServiceWorkerRegistration.cookies 읽기 전용: 웹 앱이 쿠키 변경 이벤트를 구독하고 구독을 취소할 수 있도록 해주는 CookieStoreManager 인터페이스에 대한 참조를 반환합니다.
Window.cookieStore 읽기 전용: 현재 문서 컨텍스트에 대한 CookieStore 객체에 대한 참조를 반환합니다.
cookiechange 이벤트: 서비스 워커의 쿠키 변경사항 구독 목록에 있는 쿠키가 변경될 때 마다 발생합니다.