This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
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
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)[2] | 11ms[3] | (Yes)[3] | ? | ? |
| Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | ? | 9.0 (9.0) | ? | ? | ? |
[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.