chrome.system.display

refresh date: 2026-09-25 robots: noindex

Описание

Используйте system.display API, чтобы запрашивать актуальные метаданные.

Разрешения

system.display

Типы

ActiveState

Chrome 117 и более поздних версий

Перечисление, указывающее, обнаружен ли дисплей и используется ли он системой. Дисплей считается неактивным, если он не обнаружен системой (например, отключен или считается отключенным из-за спящего режима). Это состояние используется, чтобы сохранить существующий экран, когда все экраны отключены.

Перечисление

"active"

"inactive"

Bounds

Свойства

• высота

  число

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

• влево

  число

  Координата X левого верхнего угла.

• верхняя

  число

  Координата по оси Y левого верхнего угла.

• ширина

  число

  Ширина экрана в пикселях.

DisplayLayout

Chrome 53 и более поздних версий;

Свойства

• id

  string

  Уникальный идентификатор дисплея.

• вычесть

  число

  Смещение дисплея вдоль подключенного края. Значение 0 указывает на то, что выравнивание выполняется по верхнему или левому краю.

• parentId

  string

  Уникальный идентификатор родительского дисплея. Если это корневой элемент, поле остается пустым.

• position

  LayoutPosition

  Положение макета этого экрана относительно родительского. Для корневого элемента это значение будет игнорироваться.

DisplayMode

Chrome 52 и более поздних версий;

Свойства

• deviceScaleFactor

  число

  Коэффициент масштабирования устройства в режиме отображения.

• высота

  число

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

• heightInNativePixels

  число

  Высота режима отображения в физических пикселях.

• isInterlaced

  Логическое значение (необязательно)

  Chrome 74 и более поздних версий.

  True, если этот режим чересстрочный, false, если не указано.

• isNative

  Логическое значение

  True, если режим является стандартным для дисплея.

• isSelected

  Логическое значение

  True, если режим отображения выбран.

• refreshRate

  число

  Chrome 67 и более поздних версий

  Частота обновления экрана в герцах.

• uiScale

  number (необязательно)

  Не поддерживается начиная с Chrome 70

  Использовать помощника (displayZoomFactor)

  Коэффициент масштабирования интерфейса в режиме отображения.

• ширина

  число

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

• widthInNativePixels

  число

  Ширина режима отображения в физических пикселях.

DisplayProperties

Свойства

• boundsOriginX

  number (необязательно)

  Если задано, обновляет начало логических границ дисплея по оси X. Применяется вместе с boundsOriginY. Если значение не задано, а параметр boundsOriginY задан, по умолчанию используется текущее значение. Обратите внимание, что при обновлении начала координат экрана будут применяться некоторые ограничения, поэтому окончательное начало координат границ может отличаться от заданного. Итоговые границы можно получить с помощью getInfo. Начало координат границ нельзя изменить на основном экране.

• boundsOriginY

  number (необязательно)

  Если задано, обновляет начало логических границ дисплея по оси Y. Ознакомьтесь с документацией по параметру boundsOriginX.

• displayMode

  DisplayMode необязательный

  Chrome 52 и более поздних версий;

  Если задано, обновляет режим отображения до режима, соответствующего этому значению. Если другие параметры недействительны, это не будет применено. Если режим отображения недопустим, он не будет применен и появится сообщение об ошибке, но другие свойства будут применены.

• displayZoomFactor

  number (необязательно)

  Chrome 65 и более поздних версий;

  Если задано, обновляет масштаб, связанный с дисплеем. При этом макет и отрисовка страницы меняются, что позволяет получить более качественное изображение, чем при простом попиксельном увеличении.

• isPrimary

  Логическое значение (необязательно)

  Если задано значение True, дисплей становится основным. Если задано значение false, то ничего не происходит. Примечание. Если задать это правило, дисплей будет считаться основным для всех остальных свойств (например, можно задать isUnified, а начало координат границ – нет).

• isUnified

  Логическое значение (необязательно)

  Chrome 59 и более поздних версий;

  Только для ChromeOS. Если задано значение True, режим отображения меняется на объединенный рабочий стол (подробнее об этом читайте в статье enableUnifiedDesktop). Если установлено значение False, режим единого рабочего стола будет отключен. Это правило действует только в отношении основного экрана. Если указано это свойство, то свойство mirroringSourceId указывать не нужно, а другие свойства будут игнорироваться. Если не указать, то не будет иметь эффекта.

• mirroringSourceId

  Строка (необязательно)

  Устарело начиная с Chrome 68

  используйте директиву setMirrorMode.

  Только для ChromeOS. Если задано и не пусто, включает дублирование только для этого экрана. В противном случае дублирование экрана будет отключено для всех дисплеев. Это значение должно указывать идентификатор исходного дисплея для дублирования, который не должен совпадать с идентификатором, переданным в setDisplayProperties. Если задано это свойство, другие свойства задать нельзя.

• Границы отображения

  Insets необязательно

  Если правило настроено, для полей экрана устанавливаются заданные значения. Значения не могут быть отрицательными или превышать половину размера экрана. На встроенном мониторе нельзя изменить настройки выхода за границы экрана.

• поворот

  number (необязательно)

  Если правило настроено, оно обновляет ориентацию экрана. Допустимые значения: 0, 90, 180, 270. Поворот задается по часовой стрелке относительно вертикального положения экрана.

DisplayUnitInfo

Свойства

• activeState

  ActiveState

  Chrome 117 и более поздних версий

  Активно, если дисплей обнаружен и используется системой.

• availableDisplayZoomFactors

  number[]

  Chrome 67 и более поздних версий

  Список значений коэффициента масштабирования, которые можно задать для экрана.

• bounds

  Границы

  Логические границы экрана.

• displayZoomFactor

  число

  Chrome 65 и более поздних версий;

  Соотношение между текущим и стандартным масштабом экрана. Например, значение 1 соответствует масштабу 100 %, а значение 1,5 – масштабу 150 %.

• dpiX

  число

  Количество пикселей на дюйм по оси X.

• dpiY

  число

  Количество пикселей на дюйм по оси Y.

• edid

  Edid необязательный

  Chrome 67 и более поздних версий

  Примечание. Эта функция доступна только для киоск-приложений ChromeOS.

• hasTouchSupport

  Логическое значение

  Chrome 57 и более поздних версий;

  True, если с этим экраном связано устройство сенсорного ввода.

• id

  string

  Уникальный идентификатор дисплея.

• isEnabled

  Логическое значение

  True, если этот дисплей включен.

• isPrimary

  Логическое значение

  True, если это основной экран.

• isUnified

  Логическое значение

  Chrome 59 и более поздних версий;

  True для всех экранов в режиме единого рабочего стола. Ознакомьтесь с документацией по enableUnifiedDesktop.

• mirroringDestinationIds

  string[]

  Chrome 64 и более поздних версий;

  Только для ChromeOS. Идентификаторы экранов, на которые дублируется исходный экран. Если дублирование не используется, оставьте поле пустым. Это значение будет одинаковым для всех дисплеев. Не должно содержать mirroringSourceId.

• mirroringSourceId

  string

  Только для ChromeOS. Идентификатор дублируемого экрана, если дублирование включено. В противном случае поле остается пустым. Оно будет установлено для всех экранов, включая дублируемый.

• режимы

  DisplayMode[]

  Chrome 52 и более поздних версий;

  Список доступных режимов отображения. Для текущего режима будет установлено значение isSelected=true. Доступно только в ChromeOS. На других платформах будет задан пустой массив.

• name

  string

  Удобное название (например, "ЖК-монитор HP").

• Границы отображения

  Insets

  Вставки дисплея в пределах его экрана. В настоящее время доступно только в ChromeOS. На других платформах будут установлены пустые вставки.

• поворот

  число

  Поворот дисплея по часовой стрелке в градусах относительно вертикального положения. В настоящее время доступно только в ChromeOS. На других платформах будет установлено значение 0. Значение -1 будет интерпретироваться как автоповорот, когда устройство находится в режиме планшета.

• workArea

  Границы

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

Edid

Chrome 67 и более поздних версий

Свойства

• manufacturerId

  string

  Трехсимвольный код производителя. См. раздел 3.4.1 на стр. 21. Обязательно в версии 1.4.

• идентификаторТовара

  string

  Двухбайтовый код, назначенный производителем, раздел 3. 4.2, стр.21. Обязательно в версии 1.4.

• yearOfManufacture

  число

  Год производства (раздел 3. 4.4, стр.22). Обязательно в версии 1.4.

GetInfoFlags

Chrome 59 и более поздних версий;

Свойства

• singleUnified

  Логическое значение (необязательно)

  Если задано значение True, то в режиме единого рабочего стола getInfo возвращает только один объект DisplayUnitInfo (см. enableUnifiedDesktop). По умолчанию используется значение False.

Insets

Свойства

• нижняя

  число

  Расстояние по оси Y от нижней границы.

• влево

  число

  Расстояние по оси X от левой границы.

• вправо

  число

  Расстояние по оси X от правой границы.

• верхняя

  число

  Расстояние по оси Y от верхней границы.

LayoutPosition

Chrome 53 и более поздних версий;

Положение макета, то есть край родительского элемента, к которому прикреплен дисплей.

Перечисление

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65 и более поздних версий;

Зеркальный режим, то есть разные способы дублирования экрана на другие экраны.

Перечисление

off
Задает режим по умолчанию (расширенный или единый рабочий стол).

"normal"
Указывает, что изображение с исходного экрана по умолчанию будет дублироваться на всех остальных экранах.

"mixed"
Указывает, что изображение с исходного экрана будет дублироваться на целевых экранах. Все остальные подключенные экраны будут расширены.

MirrorModeInfo

Chrome 65 и более поздних версий;

Свойства

• mirroringDestinationIds

  string[] необязательно

  Идентификаторы экранов, на которые дублируется изображение. Это значение допустимо только для смешанного типа.

• mirroringSourceId

  Строка (необязательно)

  Идентификатор исходного экрана для дублирования. Это значение допустимо только для смешанного типа.

• режим

  MirrorMode

  Зеркальный режим, который нужно установить.

Point

Chrome 57 и более поздних версий;

Свойства

• x

  число

  Координата X точки.

• y

  число

  Координата Y точки.

TouchCalibrationPair

Chrome 57 и более поздних версий;

Свойства

• displayPoint

  Point

  Координаты точки отображения.

• touchPoint

  Point

  Координаты точки касания, соответствующие точке на экране.

TouchCalibrationPairQuad

Chrome 57 и более поздних версий;

Свойства

• pair1

  TouchCalibrationPair

  Для калибровки сенсорного экрана требуется первая пара точек касания и отображения.

• pair2

  TouchCalibrationPair

  Для калибровки сенсорного экрана требуется вторая пара точек касания и отображения.

• pair3

  TouchCalibrationPair

  Для калибровки сенсорного экрана требуется третья пара точек касания и отображения.

• pair4

  TouchCalibrationPair

  Для калибровки сенсорного экрана требуется четвертая пара точек касания и отображения.

Методы

clearTouchCalibration()

Chrome 57 и более поздних версий;

chrome.system.display.clearTouchCalibration(
  id: string,
): void

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Сбрасывает калибровку сенсорного экрана и возвращает его в состояние по умолчанию, удаляя все связанные с ним данные калибровки.

Параметры

• id

  string

  Уникальный идентификатор дисплея.

completeCustomTouchCalibration()

Chrome 57 и более поздних версий;

chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Задает пары калибровки сенсорного экрана для дисплея. Эти pairs будут использоваться для калибровки сенсорного экрана с id, вызванным в startCustomTouchCalibration(). Всегда вызывайте startCustomTouchCalibration перед вызовом этого метода. Если калибровка уже выполняется, появится сообщение об ошибке.

Параметры

• пары

  TouchCalibrationPairQuad

  Пары точек, используемые для калибровки экрана.

• bounds

  Границы

  Границы экрана, когда выполнялась калибровка сенсорного экрана. Значения в тегах bounds.left и bounds.top игнорируются.

enableUnifiedDesktop()

Chrome 46 и более поздних версий;

chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Включает или отключает функцию объединенного рабочего стола. Если включить правило во время дублирования экрана, режим рабочего стола не изменится, пока дублирование не будет отключено. В противном случае режим рабочего стола сразу переключится на унифицированный.

Параметры

• включено

  Логическое значение

  Если правило включено, то будет включен режим единого рабочего стола.

getDisplayLayout()

Promise Chrome 53 и более поздних версий

chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Запрашивает информацию о макете для всех дисплеев.

Параметры

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  (layouts: DisplayLayout[]) => void

  • макеты;

    DisplayLayout[]

Возвраты

• Promise<DisplayLayout[]>

  Chrome 91 и более поздних версий

  Promise, который разрешается с результатами.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getInfo()

Promise

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
  callback?: function,
): Promise<DisplayUnitInfo[]>

Запрашивает информацию обо всех подключенных дисплеях.

Параметры

• флаги

  GetInfoFlags необязательный

  Chrome 59 и более поздних версий;

  Параметры, влияющие на то, как возвращается информация.

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  (displayInfo: DisplayUnitInfo[]) => void

  • displayInfo

    DisplayUnitInfo[]

Возвраты

• Promise<DisplayUnitInfo[]>

  Chrome 91 и более поздних версий

  Promise, который разрешается с результатами.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

overscanCalibrationAdjust()

Chrome 53 и более поздних версий;

chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Настраивает текущие вставки для компенсации развертки экрана. Обычно это должно либо перемещать дисплей вдоль оси (например, левое и правое значения одинаковы), либо масштабировать его вдоль оси (например, верхнее и нижнее значения противоположны). Каждый вызов Adjust суммируется с предыдущими вызовами с момента запуска.

Параметры

• id

  string

  Уникальный идентификатор дисплея.

• Делта

  Insets

  Значение, на которое нужно изменить вставки.

overscanCalibrationComplete()

Chrome 53 и более поздних версий;

chrome.system.display.overscanCalibrationComplete(
  id: string,
): void

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Завершить настройку области развертки для экрана, сохранив текущие значения и скрыв оверлей.

Параметры

• id

  string

  Уникальный идентификатор дисплея.

overscanCalibrationReset()

Chrome 53 и более поздних версий;

chrome.system.display.overscanCalibrationReset(
  id: string,
): void

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Сбрасывает вставки для компенсации переразвертки до последнего сохраненного значения (то есть до вызова Start).

Параметры

• id

  string

  Уникальный идентификатор дисплея.

overscanCalibrationStart()

Chrome 53 и более поздних версий;

chrome.system.display.overscanCalibrationStart(
  id: string,
): void

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Запускает калибровку развертки для экрана. На экране появится оверлей с текущими значениями полей. Если калибровка развертки для экрана id уже выполняется, она будет сброшена.

Параметры

• id

  string

  Уникальный идентификатор дисплея.

setDisplayLayout()

Promise Chrome 53 и более поздних версий

chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
  callback?: function,
): Promise<void>

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Настройте макет для всех дисплеев. Для всех остальных дисплеев будет использоваться макет по умолчанию. Если макет перекрывается или недействителен по другой причине, он будет скорректирован. После того как макет будет определен, активируется событие onDisplayChanged.

Параметры

• макеты;

  DisplayLayout[]

  Информация о макете, необходимая для всех дисплеев, кроме основного.

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  () => void

Возвраты

• Promise<void>

  Chrome 91 и более поздних версий

  Объект Promise, который распознается, когда функция завершает работу.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

setDisplayProperties()

Promise

chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
  callback?: function,
): Promise<void>

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Обновляет свойства дисплея, указанного в id, в соответствии с информацией, предоставленной в info. В случае сбоя будет задано значение runtime.lastError.

Параметры

• id

  string

  Уникальный идентификатор дисплея.

• информация

  DisplayProperties

  Информация о свойствах экрана, которые нужно изменить. Свойство будет изменено, только если для него указано новое значение в info.

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  () => void

Возвраты

• Promise<void>

  Chrome 91 и более поздних версий

  Объект Promise, который распознается, когда функция завершает работу.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

setMirrorMode()

Promise Chrome 65 и более поздние версии

chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Устанавливает указанный зеркальный режим. Каждый вызов сбрасывает состояние предыдущих вызовов. Вызов setDisplayProperties() для целевых экранов дублирования не сработает.

Параметры

• информация

  MirrorModeInfo

  Информация о зеркальном режиме, который должен быть применен к режиму отображения.

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  () => void

Возвраты

• Promise<void>

  Chrome 91 и более поздних версий

  Объект Promise, который распознается, когда функция завершает работу.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

showNativeTouchCalibration()

Promise Chrome 57+

chrome.system.display.showNativeTouchCalibration(
  id: string,
  callback?: function,
): Promise<boolean>

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Показывает встроенный интерфейс калибровки сенсорного экрана с идентификатором id. На экране появится оверлей с инструкциями. Обратный вызов будет инициироваться только в случае успешной калибровки. Если калибровка не удастся, появится сообщение об ошибке.

Параметры

• id

  string

  Уникальный идентификатор дисплея.

• обратный вызов

  function необязательно

  Параметр callback выглядит следующим образом:

  (success: boolean) => void

  • выполнено

    Логическое значение

Возвраты

• Promise<boolean>

  Chrome 91 и более поздних версий

  Объект Promise, который сообщает вызывающей стороне, что калибровка сенсорного экрана завершена. Логическое значение, которое сообщает, была ли калибровка успешной.

  Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

startCustomTouchCalibration()

Chrome 57 и более поздних версий;

chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

Примечание. Эта функция доступна только для киоск-приложений ChromeOS. Запускает пользовательскую калибровку сенсорного экрана. Этот метод следует вызывать при использовании собственного UX для сбора данных калибровки. Если калибровка уже выполняется, появится сообщение об ошибке.

Параметры

• id

  string

  Уникальный идентификатор дисплея.

События

onDisplayChanged

chrome.system.display.onDisplayChanged.addListener(
  callback: function,
)

Срабатывает при изменении конфигурации дисплея.

Параметры

• обратный вызов

  function

  Параметр callback выглядит следующим образом:

  () => void