Web/API/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.

Properties

Screen.availTop ': Specifies the y-coordinate of the first pixel that is not allocated to permanent or semipermanent user interface features.
Screen.availLeft ': Returns the first available pixel available from the left side of the screen.
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.left ': 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 instance associated with this screen.
Screen.pixelDepth: Gets the bit depth of the screen.
Screen.top ': Returns the distance in pixels from the top side of the current screen.
Screen.width: Returns the width of the screen.
Screen.mozEnabled ' ': Boolean. Setting to false will turn off the device's screen.
Screen.mozBrightness ' ': Controls the brightness of a device's screen. A double between 0 and 1.0 is expected.

Events handler

Screen.onorientationchange ': A handler for the orientationchange event.

Methods

Screen.lockOrientation: Lock the screen orientation (only works in fullscreen or for installed apps)
Screen.unlockOrientation: Unlock the screen orientation (only works in fullscreen or for installed apps)

Methods inherited from EventTarget:

EventTarget.addEventListener(): Registers an event handler of a specific event type on the EventTarget.
EventTarget.removeEventListener(): Removes an event listener from the EventTarget.
EventTarget.dispatchEvent(): Dispatches an event to this EventTarget.

Additional methods in Mozilla chrome codebase

Mozilla includes a couple of extensions for use by JS-implemented event targets to implement onevent properties.

Example

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

Specification

Specification	Status	Comment
CSS Object Model (CSSOM) View ModuleThe definition of 'Screen' in that specification.	Working Draft	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`Screen`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE Full support Yes	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`availHeight`	Chrome Full support 40	Edge Full support 12 Notes' Full support 12 Notes' Notes' Always reflects the main screen.	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support 40	Chrome Android Full support 40	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 4.0
`availLeft` Non-standard'	Chrome Full support Yes	Edge Full support 79	Firefox Full support Yes	IE No support No	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android Full support Yes
`availTop` Non-standard'	Chrome Full support 40	Edge Full support 79	Firefox Full support Yes	IE No support No	Opera Full support Yes	Safari Full support 6	WebView Android Full support 40	Chrome Android Full support 40	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android Full support 4.0
`availWidth`	Chrome Full support Yes	Edge Full support 12 Notes' Full support 12 Notes' Notes' Always reflects the main screen.	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`colorDepth`	Chrome Full support 40 Notes' Full support 40 Notes' Notes' Starting with version 59 this property is no longer required to always return 24.	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support 40 Notes' Full support 40 Notes' Notes' Starting with version 59 this property is no longer required to always return 24.	Chrome Android Full support 40 Notes' Full support 40 Notes' Notes' Starting with version 59 this property is no longer required to always return 24.	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 4.0 Notes' Full support 4.0 Notes' Notes' Starting with Samsung Internet 7.0 this property is no longer required to always return 24.
`height`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`left` Non-standard'	Chrome No support No	Edge No support ≤18 — 79	Firefox Full support Yes	IE ?	Opera No support No	Safari Full support Yes	WebView Android No support No	Chrome Android No support No	Firefox Android Full support Yes	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No
`lockOrientation`	Chrome Full support 38	Edge Full support 12 Prefixed' Full support 12 Prefixed' Prefixed' Implemented with the vendor prefix: ms	Firefox Full support Yes Prefixed' Full support Yes Prefixed' Prefixed' Implemented with the vendor prefix: moz	IE Full support 11 Prefixed' Full support 11 Prefixed' Prefixed' Implemented with the vendor prefix: ms	Opera Full support Yes	Safari No support No	WebView Android Full support 38	Chrome Android Full support 38	Firefox Android Full support Yes Prefixed' Full support Yes Prefixed' Prefixed' Implemented with the vendor prefix: moz	Opera Android Full support Yes	Safari iOS No support No	Samsung Internet Android Full support 3.0
`mozBrightness` Deprecated'Non-standard'	Chrome No support No	Edge No support No	Firefox Full support 12 Disabled' Full support 12 Disabled' Disabled' From version 12: this feature is behind the `dom.screenBrightnessProperty.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android Full support 14 Disabled' Full support 14 Disabled' Disabled' From version 14: this feature is behind the `dom.screenBrightnessProperty.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS No support No	Samsung Internet Android No support No
`mozEnabled` Deprecated'Non-standard'	Chrome No support No	Edge No support No	Firefox Full support 12 Disabled' Full support 12 Disabled' Disabled' From version 12: this feature is behind the `dom.screenEnabledProperty.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android Full support 14 Disabled' Full support 14 Disabled' Disabled' From version 14: this feature is behind the `dom.screenEnabledProperty.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS No support No	Samsung Internet Android No support No
`onorientationchange`	Chrome No support No	Edge No support ≤18 — 79 Alternate Name' No support ≤18 — 79 Alternate Name' Alternate Name' Uses the non-standard name: `onmsorientationchange`	Firefox No support No	IE No support No	Opera No support No	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android Full support Yes Alternate Name' Full support Yes Alternate Name' Alternate Name' Uses the non-standard name: `onmozorientationchange`	Opera Android No support No	Safari iOS No support No	Samsung Internet Android No support No
`orientation`	Chrome Full support 38	Edge Full support 12 Prefixed' Notes' Full support 12 Prefixed' Notes' Prefixed' Implemented with the vendor prefix: ms Notes' Edge does not return an `Orientation` object; instead, it returns the orientation type as a string.	Firefox Full support Yes Full support Yes Full support Yes Prefixed' Prefixed' Implemented with the vendor prefix: moz	IE Full support 11 Prefixed' Notes' Full support 11 Prefixed' Notes' Prefixed' Implemented with the vendor prefix: ms Notes' Not supported on Windows 7.	Opera Full support 25	Safari No support No	WebView Android No support No	Chrome Android Full support 39	Firefox Android Full support Yes Full support Yes Full support Yes Prefixed' Prefixed' Implemented with the vendor prefix: moz	Opera Android No support No	Safari iOS No support No	Samsung Internet Android Full support 4.0
`pixelDepth`	Chrome Full support 40 Notes' Full support 40 Notes' Notes' Starting with version 59 this property is no longer required to always return 24.	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes Notes' Full support Yes Notes' Notes' Starting with version 59 this property is no longer required to always return 24.	Chrome Android Full support Yes Notes' Full support Yes Notes' Notes' Starting with version 59 this property is no longer required to always return 24.	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes Notes' Full support Yes Notes' Notes' Starting with Samsung Internet 7.0 this property is no longer required to always return 24.
`top` Deprecated'Non-standard'	Chrome No support No	Edge No support ≤18 — 79	Firefox Full support Yes	IE ?	Opera No support No	Safari Full support Yes	WebView Android No support No	Chrome Android No support No	Firefox Android Full support Yes	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No
`unlockOrientation`	Chrome Full support 38	Edge Full support 12 Prefixed' Full support 12 Prefixed' Prefixed' Implemented with the vendor prefix: ms	Firefox Full support Yes Prefixed' Full support Yes Prefixed' Prefixed' Implemented with the vendor prefix: moz	IE Full support 11 Prefixed' Full support 11 Prefixed' Prefixed' Implemented with the vendor prefix: ms	Opera Full support Yes	Safari No support No	WebView Android Full support 38	Chrome Android Full support 38	Firefox Android Full support Yes Prefixed' Full support Yes Prefixed' Prefixed' Implemented with the vendor prefix: moz	Opera Android Full support Yes	Safari iOS No support No	Samsung Internet Android Full support 3.0
`width`	Chrome Full support 40	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support 40	Chrome Android Full support 40	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 4.0

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Non-standard. Expect poor cross-browser support.': Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.': Deprecated. Not for use in new websites.
See implementation notes.': See implementation notes.
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.

Screen by Mozilla Contributors is licensed under CC-BY-SA 2.5.