ScreenDetailed

Интерфейс ScreenDetailed API управления окнами представляет собой подробную информацию об одном конкретном экране, доступном устройству пользователя.

К объектам ScreenDetailed можно получить доступ через свойства ScreenDetails.screens и ScreenDetails.currentScreen.

Наследует свойства от родительского класса Screen.

availLeft Только для чтения Экспериментально

Число, представляющее координату x (левый край) доступной области экрана.

availTop Только для чтения Экспериментально

Число, представляющее координату y (верхний край) доступной области экрана.

devicePixelRatio Только для чтения Экспериментально

Число, представляющее коэффициент пикселей устройства экрана.

isInternal Только для чтения Экспериментально

Булево значение, указывающее, является ли экран внутренним для устройства или внешним.

isPrimary Только для чтения Экспериментально

Булево значение, указывающее, установлен ли экран в качестве основного экрана операционной системы (ОС).

label Только для чтения Экспериментально

Строка, предоставляющая описательную метку для экрана, например "Встроенный дисплей Retina".

left Только для чтения Экспериментально

Число, представляющее координату x (левый край) всей области экрана.

top Только для чтения Экспериментально

Число, представляющее координату y (верхний край) всей области экрана.

Наследует события от родительского класса Screen.

change Экспериментально

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

При вызове Window.getScreenDetails(), пользователю будет предложено предоставить разрешение на управление окнами на всех их дисплеях (статус этого разрешения можно проверить с помощью Permissions.query() для запроса window-management). При предоставлении разрешения полученный объект ScreenDetails содержит объекты ScreenDetailed , представляющие все доступные пользователю экраны.

Следующий пример открывает окно в левом верхнем углу основного экрана ОС:

// Return ScreenDetails
const allScreens = await window.getScreenDetails();

// Return the primary screen ScreenDetailed object
const primaryScreenDetailed = allScreens.screens.find(
  (screenDetailed) => screenDetailed.isPrimary,
);

// Open a window in the top-left corner of the OS primary screen
window.open(
  "https://example.com",
  "_blank",
  `left=${primaryScreenDetailed.availLeft},
   top=${primaryScreenDetailed.availTop},
   width=200,
   height=200`,
);

• API управления окнами