---
title: Screen
slug: Web/API/Screen
tags:
- API
translation_of: Web/API/Screen
---
{{APIRef("CSSOM View")}}
The Screen
interface represents a screen, usually the one on which the current window is being rendered.
Usually it is the one on which the current window is being rendered, obtained using window.screen
.
Properties
- {{domxref("Screen.availTop")}}
- Specifies the y-coordinate of the first pixel that is not allocated to permanent or semipermanent user interface features.
- {{domxref("Screen.availLeft")}}
- Returns the first available pixel available from the left side of the screen.
- {{domxref("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.
- {{domxref("Screen.availWidth")}}
- Returns the amount of horizontal space in pixels available to the window.
- {{domxref("Screen.colorDepth")}}
- Returns the color depth of the screen.
- {{domxref("Screen.height")}}
- Returns the height of the screen in pixels.
- {{domxref("Screen.left")}}
- Returns the distance in pixels from the left side of the main screen to the left side of the current screen.
- {{domxref("Screen.orientation")}}
- Returns the current orientation of the screen.
- {{domxref("Screen.pixelDepth")}}
- Gets the bit depth of the screen.
- {{domxref("Screen.top")}}
- Returns the distance in pixels from the top side of the current screen.
- {{domxref("Screen.width")}}
- Returns the width of the screen.
- {{domxref("Screen.mozEnabled")}} {{gecko_minversion_inline("12.0")}}
- Boolean. Setting to false will turn off the device's screen.
- {{domxref("Screen.mozBrightness")}} {{gecko_minversion_inline("12.0")}}
- Controls the brightness of a device's screen. A double between 0 and 1.0 is expected.
Events handler
- {{domxref("Screen.onorientationchange")}}
- A handler for the {{event("orientationchange")}} events.
Methods
- {{domxref("Screen.lockOrientation")}}
- Lock the screen orientation (only works in fullscreen or for installed apps)
- {{domxref("Screen.unlockOrientation")}}
- Unlock the screen orientation (only works in fullscreen or for installed apps)
Methods inherit from {{domxref("EventTarget")}}
{{page("/en-US/docs/Web/API/EventTarget","Methods")}}
Example
if (screen.pixelDepth < 8) {
// use low-color version of page
} else {
// use regular, colorful page
}
Specification
CSSOM View