Window.fullScreen

Summary

This property indicates whether the window is displayed in full screen mode or not. It is only reliable in Gecko 1.9 (Firefox 3) and later, see the Notes below.

Syntax

isInFullScreen = windowRef.fullScreen;

With chrome privileges, the property is read-write, otherwise it is read-only. Bear in mind that if you try to set this property without chrome privileges, it will not throw an exception and instead just silently fail. This is to prevent scripts designed to set this property in Internet Explorer from breaking.

Return Value

isInFullScreen
A boolean. Possible Values:
  • true: The window is in full screen mode.
  • false: The window is not in full screen mode.

Examples

if (window.fullScreen) {
  // it's fullscreen!
}
else {
  // not fullscreen!
}

Specification

DOM Level 0. window.fullScreen is not part of any W3C specification or technical recommendation.

Notes

  • This property is only reliable in Mozilla 1.9 (Firefox 3) and later. Mozilla 1.8 and earlier do have this property, but it always returns false, even when the window is in full screen mode (bug 127013).
  • Switching between regular window and full screen will fire the "resize" event on the corresponding window.

Document Tags and Contributors

 Last updated by: aziz512,