DOM

settings_applicationsEventTarget  >   settings_applicationsNode  >   settings_applicationsElement  >   settings_applications[[Prototype]]

DOM

Editing
  • account_tree
  • bug_report

PromisepromiserequestFullscreen(Objectoptions])

비동기 요청으로 요소를 전체 화면 모드로 표시한다.

설명

요소가 전체 화면 모드로 무조건 전환된다는 보장은 없다. 그러므로 비동기적인 요청으로 처리되고 Promise 객체가 수신하게 된다.

성공적인 전체 화면 모드 전환이 예상되면 Promise 객체는 이행(fulfilled) 처리되고 fullscreenchange 이벤트를 수신한다. 그렇지 않다면 Promise 객체는 거부(rejected) 처리되고 fullscreenerror 이벤트를 수신한다.

구문

형식
element.requestFullscreen([options])

매개 변수

Objectoptions선택

사용 가능한 선택적인 옵션은 다음과 같다.

navigationUI
요소가 전체 화면 모드에 있는 동안 웹브라우저의 네비게이션 UI를 표시할지 여부를 제어한다.
  • "auto" : 기본 값이며 웹브라우저가 결정한다.
  • "hide" : 네비게이션 UI는 숨겨지고 요소가 화면 전체 크기에 표시된다.
  • "show" : 네비게이션 UI와 기타 사용자 인터페이스가 표시된다.
screen
현재 실험 단계의 옵션이며 요소를 전체 화면 모드로 표시할 화면을 지정한다. 선택한 화면을 나타내는 ScreenDetailed 객체를 값으로 사용한다.

반환

Promisepromise

Promise 객체를 반환한다.

다음의 경우 TypeError 예외가 발생할 수 있다.

  • 해당 요소가 포함된 문서가 활성된 문서가 아닐 경우
  • 해당 요소가 현재 문서에 포함되지 않은 경우
  • 어떠한 이유로 요소에서 전체화면 기능이 허용되지 않은 경우
  • 해당 요소와 문서는 동일한 노드일 경우
  • 요소가 HTMLElement.prototype.showPopover()를 통해 이미 사용중일 경우

Exception

TypeError

동적 타입의 값이 흐름상 맞지 않는 자료형이라 연산을 할 수 없을 때 발생하는 오류를 다루는 객체이다.

지원 웹브라우저