The read-only fullscreenEnabled
property on the Document
interface indicates whether or not full-screen mode is available. Full-screen mode is available only for a page that has no windowed plug-ins in any of its documents, and if all <iframe>
elements which contain the document have their allowfullscreen
attribute set.
Although this property is read-only, it will not throw if it is modified (even in strict mode); the setter is a no-operation and it will be ignored.
Syntax
var isFullscreenAvailable = document.fullscreenEnabled;
Value
A Boolean
value which is true
if the document and the elements within can be placed into full-screen mode by calling Element.requestFullscreen()
. If full-screen mode isn't available, this value is false
.
Example
In this example, before attempting to request full-screen mode for a <video>
element, the value of fullscreenEnabled
is checked, in order to avoid making the attempt when not available.
function requestFullScreen() { if (document.fullscreenEnabled) { videoElement.requestFullScreen(); } else { console.log('Your browser cannot use fullscreen right now'); } }
Specifications
Specification | Status | Comment |
---|---|---|
Fullscreen API The definition of 'Document.fullscreenEnabled' in that specification. |
Living Standard | Initial definition |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
fullscreenEnabled | Chrome
Full support
45
| Edge Full support 12 | Firefox
Full support
64
| IE
Full support
11
| Opera Full support Yes | Safari ? | WebView Android
Full support
45
| Chrome Android
Full support
45
| Firefox Android
Full support
64
| Opera Android Full support Yes | Safari iOS ? | Samsung Internet Android
Full support
5.0
|
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- User must explicitly enable this feature.
- User must explicitly enable this feature.
- Uses a non-standard name.
- Uses a non-standard name.
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.