JavaScript Indexing

settings_applicationsEventTarget  >   settings_applicationsNode  >   settings_applicationsDocument  >   settings_applications[[Prototype]]

{object_name}

Editing

PromisepromiserequestStorageAccess()

Details

로드된 현재 문서가 분할되지 않은 쿠키에 대한 접근을 요청한다.

설명

유저 에이전트는 개인 정보 보호를 위해서 타사(third-party) 컨텍스트(context)에 로드된 사이트의 분할되지 않은 쿠키에 대한 접근을 기본적으로 차단할 수 있다. 따라서 합법적인 사용을 위해서 유저 에이전트에게 분할되지 않은 쿠키에 대한 접근을 요청할 수 있다. 자세한 내용은 Storage Access API를 참고하기 바란다.

구문

형식
document.requestStorageAccess()

반환

Promisepromise

요청이 허용되면 정의되지 않은 상태(undefined)로 이행(resolve)하고 그렇지 않다면 거부(reject)하는 Promise 객체를 반환한다.

다음과 같이 DOMException 예외가 발생한다.

InvalidStateError
현재 문서가 아직 활성화되지 않은 경우에 발생한다.
NotAllowedError
다음과 같은 경우에 발생한다.
  • 현재 창(window)이 보안 컨텍스트(secure context)가 아닌 경우
  • 저장소 접근 권한 정책에 따라 사용이 차단된 경우
  • document 또는 최상위 document의 원본이 null인 경우
  • 샌드박스(snadbox)로 동작하는 아이프레임(iframe)이며 allow-storage-access-by-user-activation 토큰이 설정되지 않은 경우

Exception

DOMException

DOM API의 메소드를 호출하거나 프로퍼티에 접근한 결과 발생하는 비정상적인 이벤트(예외)를 나타낸다.

지원 웹브라우저