로드된 현재 문서가 분할되지 않은 쿠키에 대한 접근을 요청한다.
유저 에이전트는 개인 정보 보호를 위해서 타사(third-party) 컨텍스트(context)에 로드된 사이트의 분할되지 않은 쿠키에 대한 접근을 기본적으로 차단할 수 있다. 따라서 합법적인 사용을 위해서 유저 에이전트에게 분할되지 않은 쿠키에 대한 접근을 요청할 수 있다. 자세한 내용은 Storage Access API
를 참고하기 바란다.
document.requestStorageAccess()
요청이 허용되면 정의되지 않은 상태(undefined)로 이행(resolve)하고 그렇지 않다면 거부(reject)하는 Promise
객체를 반환한다.
다음과 같이 DOMException
예외가 발생한다.
InvalidStateError
NotAllowedError
document
또는 최상위 document
의 원본이 null
인 경우allow-storage-access-by-user-activation
토큰이 설정되지 않은 경우DOM API의 메소드를 호출하거나 프로퍼티에 접근한 결과 발생하는 비정상적인 이벤트(예외)를 나타낸다.