Element.requestFullscreen()

Element.requestFullscreen() メソッドは、要素を全画面表示するための非同期的な要求を発行します。

要素が全画面モードに移行することは保証されていません。全画面モードに移行する許可が与えられている場合は、返される Promise が解決され、文書が全画面モードになったことを知ることができる fullscreenchange イベントを受け取るようになります。権限が拒否された場合は、代わりに fullscreenerror イベントを受け取ります。

このメソッドはユーザーの操作又は機器の方向の変更によって呼び出す必要があり、そうでなければ失敗します。

var Promise = Element.requestFullscreen();

なし。

全画面への移行が完了した場合は、 undefined の値で解決した Promise。

全画面のリクエストが失敗した場合は、 Promise が例外で拒否されるかもしれません。発生しうる例外は以下の通りです。

• 要素の文書が、全画面への移行ができる状態にない (つまり、 defaultView がない)。
• 要素が HTML, SVG, Math の要素ではない
• 全画面が許可されていない (例えば、ユーザーの操作ではない) 又は対応していない。

TypeError

以下の状況の一つが発生する可能性あります。

requestFullscreen() を呼び出す前に、 fullscreenchange 及び fullscreenerror イベントのハンドラーを設定してください。そうすれば、いつ全画面モードに切り替えることに成功したか (又は権限がなくて拒否されたか) を知ることができます。

tbd

• 全画面 API
• Document.exitFullscreen()
• Document.fullscreen
• Document.fullscreenElement
• :fullscreen
• allowfullscreen