Screen

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Интерфейс Screen представляет экран, обычно отображающий текущее окно, его можно получить с помощью window.screen.

Обратите внимание, что браузеры определяют текущим тот экран, который находится в центре окна браузера.

Свойства экземпляра

Также наследует свойства от своего родительского объекта EventTarget.

Screen.availHeight

Возвращает высоту экрана в пикселях за исключением постоянных или «полупостоянных» элементов пользовательского интерфейса, отображаемых операционной системой, таких как панель задач в Windows.

Screen.availWidth

Возвращает размер доступного окну горизонтального пространства в пикселях.

Screen.colorDepth

Возвращает глубину цвета экрана.

Screen.height

Возвращает высоту экрана в пикселях.

Screen.isExtended Экспериментальная возможность Secure context

Возвращает true если устройство пользователя имеет несколько экранов и false в противном случае.

Screen.orientation

Возвращает экземпляр ScreenOrientation связанный с экраном.

Screen.pixelDepth

Возвращает количество битов информации на один пиксель экрана.

Screen.width

Возвращает ширину экрана.

Screen.mozEnabled Не стандартно Устарело

Значение типа Boolean. Установка в false отключает экран.

Screen.mozBrightness Не стандартно Устарело

Управляет яркостью экрана. Ожидается значение в диапазоне от 0 до 1.0.

Методы экземпляра

Также наследует методы от своего родительского объекта EventTarget.

Screen.lockOrientation Устарело

Блокирует ориентацию экрана (доступно только в полноэкранном режиме или для установленных приложений)

Screen.unlockOrientation Устарело

Разблокирует ориентацию экрана (доступно только в полноэкранном режиме или для установленных приложений)

События

change Экспериментальная возможность Secure context

Возникает, когда происходит изменение экрана — его ширины или высоты, доступной ширины или высоты, глубины цвета или ориентации.

orientationchange Устарело Не стандартно

Возникает, когда происходит изменение ориентации экрана.

Примеры

js
if (screen.colorDepth < 8) {
  // использовать версию страницы с неполным количеством цветов
} else {
  // использовать обычную полноцветную версию страницу
}

Спецификации

Specification
CSSOM View Module
# the-screen-interface

Совместимость с браузерами

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Screen
availHeight
availLeft
Non-standard
Relative to the Multi-screen origin
Non-standard
availTop
Non-standard
Relative to the Multi-screen origin
Non-standard
availWidth
change event
Experimental
colorDepth
height
isExtended
Experimental
left
Non-standard
Relative to the Multi-screen origin
Non-standard
lockOrientation
Deprecated
mozBrightness
DeprecatedNon-standard
mozEnabled
DeprecatedNon-standard
orientation
orientationchange event
DeprecatedNon-standard
pixelDepth
top
DeprecatedNon-standard
Relative to the Multi-screen origin
DeprecatedNon-standard
unlockOrientation
Deprecated
width

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Requires a vendor prefix or different name for use.
Has more compatibility info.