ScreenDetails

Интерфейс ScreenDetails из API управления окнами представляет детали всех экранов, доступных устройству пользователя.

Доступ к этой информации осуществляется через метод Window.getScreenDetails().

Наследует свойства от своего родителя, EventTarget.

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

Один объект ScreenDetailed, представляющий подробную информацию о экране, на котором отображается текущее окно браузера.

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

Массив объектов ScreenDetailed, каждый из которых представляет подробную информацию об одном конкретном экране, доступном устройству пользователя.

Примечание: screens включает только "расширенные" дисплеи, а не те, которые дублируют другой дисплей.

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

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

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

Срабатывает, когда экраны подключаются или отключаются от системы.

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

Пример ниже открывает окно полного размера на каждом доступном экране.

const screenDetails = await window.getScreenDetails();

// Open a window on each screen of the device
for (const screen of screenDetails.screens) {
  openWindow(
    screen.availLeft,
    screen.availTop,
    screen.availWidth,
    screen.availHeight,
    url,
  );
}

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

const screenDetails = await window.getScreenDetails();

// Return the number of screens
let noOfScreens = screenDetails.screens.length;

screenDetails.addEventListener("screenschange", () => {
  // If the new number of screens is different to the old number of screens,
  // report the difference
  if (screenDetails.screens.length !== noOfScreens) {
    console.log(
      `The screen count changed from ${noOfScreens} to ${screenDetails.screens.length}`,
    );

    // Update noOfScreens value
    noOfScreens = screenDetails.screens.length;
  }

  // Open, close, or rearrange windows as needed,
  // to fit the new screen configuration
  updateWindows();
});

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