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 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

JavaScript
elt.requestFullscreen();

Specifications

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

Browser compatibility

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

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/element/requestfullscreen

API Document Fullscreen API Method Reference