Element.requestFullscreen()

The Element.requestFullscreen() method issues an asynchronous request to make the element be displayed full-screen.

It's not guaranteed that the element will be put into full screen mode. If permission to enter full screen mode is granted, the document will receive a fullscreenchange event to let it know that it's now in full screen mode. If permission is denied, the document receives a fullscreenerror event instead.

Only elements which are in the HTML namespace (that is, elements which are standard HTML), plus the <svg> and <math> elements, which are located in the top-level document or in an <iframe> with the allowfullscreen attribute can be displayed full-screen. This means that elements inside a <frame> or an <object> can't.

Syntax

Element.requestFullscreen();

Example

Before calling requestFullScreen(), set up event handlers for the fullscreenchange and fullscreenerror events, so you know when you've successfully switched into full-screen mode (or when permission to do so has been denied).

tbd

Specifications

Specification Status Comment
Fullscreen API
The definition of 'Element.requestFullScreen()' in that specification.
Living Standard Initial definition

Browser compatibility

Feature Chrome Edge Firefox Internet Explorer Edge Opera Safari
Basic support (Yes)webkit[1] (Yes) 9.0 (9.0) as mozRequestFullScreen[2]
47.0 (47.0) (behind full-screen-api.unprefix.enabled
11ms[3] (Yes)[3] ? ?
Feature Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? (Yes) 9.0 (9.0) as mozRequestFullScreen[2]
47.0 (47.0) (behind full-screen-api.unprefix.enabled
? ? ?

[1] Also implemented as webkitRequestFullScreen.

[2] Implemented as mozRequestFullScreen (notice the capital S for Screen). Before Firefox 44, Gecko incorrectly allowed elements inside a <frame> or an <object> to request, and to be granted, fullscreen. In Firefox 44 and onwards this has been fixed: only elements in the top-level document or in an <iframe> with the allowfullscreen attribute can be displayed fullscreen.

[3] See documentation on MSDN.

See also

Document Tags and Contributors

 Last updated by: Sheppy,