Screen
The Screen
interface represents a screen, usually the one on which the current window is being rendered, and is obtained using window.screen
.
Note that browsers determine which screen to report as current by detecting which screen has the center of the browser window.
Instance properties
Also inherits properties from its parent EventTarget
.
Screen.availHeight
-
Specifies the height of the screen, in pixels, minus permanent or semipermanent user interface features displayed by the operating system, such as the Taskbar on Windows.
Screen.availWidth
-
Returns the amount of horizontal space in pixels available to the window.
Screen.colorDepth
-
Returns the color depth of the screen.
Screen.height
-
Returns the height of the screen in pixels.
Screen.isExtended
Experimental Secure context-
Returns
true
if the user's device has multiple screens, andfalse
if not. Screen.orientation
-
Returns the
ScreenOrientation
instance associated with this screen. Screen.pixelDepth
-
Gets the bit depth of the screen.
Screen.width
-
Returns the width of the screen.
Screen.mozEnabled
Non-standard Deprecated-
Boolean. Setting to false will turn off the device's screen.
Screen.mozBrightness
Non-standard Deprecated-
Controls the brightness of a device's screen. A double between 0 and 1.0 is expected.
Non-standard properties
The following properties are specified as part of the Window Management API, which makes them available on the ScreenDetailed
interface; this is where we have chosen to document them. However, non-standard versions of these properties are available on the Screen
interface in browsers that don't support that API. See this page's Browser compatibility table for details of the non-standard support.
Screen.availLeft
Read only Non-standard Secure context-
A number representing the x-coordinate (left-hand edge) of the available screen area.
Screen.availTop
Read only Non-standard Secure context-
A number representing the y-coordinate (top edge) of the available screen area.
Screen.left
Read only Non-standard Secure context-
A number representing the x-coordinate (left-hand edge) of the total screen area.
Screen.top
Read only Non-standard Deprecated Secure context-
A number representing the y-coordinate (top edge) of the total screen area.
Instance methods
Also inherits methods from its parent EventTarget
.
Screen.lockOrientation
Deprecated-
Lock the screen orientation (only works in fullscreen or for installed apps)
Screen.unlockOrientation
Deprecated-
Unlock the screen orientation (only works in fullscreen or for installed apps)
Events
change
Experimental Secure context-
Fired on a specific screen when it changes in some way — width or height, available width or height, color depth, or orientation.
orientationchange
Deprecated Non-standard-
Fires when the screen orientation changes.
Examples
if (screen.colorDepth < 8) {
// use low-color version of page
} else {
// use regular, colorful page
}
Specifications
Specification |
---|
CSSOM View Module # the-screen-interface |
Browser compatibility
BCD tables only load in the browser