Screen

The Screen interface represents a screen, usually the one on which the current window is being rendered, and is obtained using window.screen (en-US).

Note that browsers determine which screen to report as current by detecting which screen has the center of the browser window.

Properties

Screen.availTop (en-US) Non-standard

Specifies the y-coordinate of the first pixel that is not allocated to permanent or semipermanent user interface features.

Screen.availLeft (en-US) Non-standard

Returns the first available pixel available from the left side of the screen.

Screen.availHeight (en-US)

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 (en-US)

Returns the amount of horizontal space in pixels available to the window.

Screen.colorDepth (en-US)

Returns the color depth of the screen.

Screen.height (en-US)

Returns the height of the screen in pixels.

Screen.left (en-US) Non-standard

Returns the distance in pixels from the left side of the main screen to the left side of the current screen.

Screen.orientation

Returns the ScreenOrientation (en-US) instance associated with this screen.

Screen.pixelDepth (en-US)

Gets the bit depth of the screen.

Screen.top (en-US) Deprecated Non-standard

Returns the distance in pixels from the top side of the current screen.

Screen.width (en-US)

Returns the width of the screen.

Screen.mozEnabled (en-US) Non-standard Deprecated

Boolean. Setting to false will turn off the device's screen.

Screen.mozBrightness (en-US) Non-standard Deprecated

Controls the brightness of a device's screen. A double between 0 and 1.0 is expected.

Events handler

Screen.onorientationchange Deprecated

A handler for the orientationchange event.

Methods

Screen.lockOrientation Non-standard Deprecated

Lock the screen orientation (only works in fullscreen or for installed apps)

Screen.unlockOrientation Non-standard Deprecated

Unlock the screen orientation (only works in fullscreen or for installed apps)

Example

if (screen.pixelDepth < 8) {
  // use low-color version of page
} else {
  // use regular, colorful page
}

Specifications

Specification
Unknown specification
# the-screen-interface

Browser compatibility

BCD tables only load in the browser