Spec-Zone.ru › Web APIs

Окно: метод getScreenDetails()

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Экспериментально: Это экспериментальная технология экспериментальная технология
Перед использованием в рабочей среде тщательно проверьте таблицу совместимости браузеров таблицу совместимости браузеров.

Безопасный контекст: Данная функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих поддерживающих браузерах.

Метод getScreenDetails() интерфейса Window возвращает Promise, который завершается объектом ScreenDetails, представляющим данные обо всех доступных экранах устройства пользователя.

Синтаксис

getScreenDetails()

Параметры

Нет.

Возвращаемое значение

Promise, который завершается объектом ScreenDetails.

Исключения

NotAllowedError DOMException

Выбрасывается, если задан window-management Политики разрешений, блокирующий использование API управления окнами, или если пользователь явно запретил запрошенное разрешение браузера на использование API.

Примеры

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

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

const screenDetails = await window.getScreenDetails();

// Open a full-size window on each screen available to the device
for (const screen of screenDetails.screens) {
  window.open(
    "https://example.com",
    "_blank",
    `left=${screen.availLeft},
    top=${screen.availTop},
    width=${screen.availWidth},
    height=${screen.availHeight}`,
  );
}

Примечание: См. Многооконную учебную среду для полного примера (также см. исходный код).

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

Спецификация
Управление окнами
# api-window-getScreenDetails-method

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

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
getScreenDetails 100 100 Нет 86 Нет 100 Нет 69 Нет 19.0 100

См. также

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

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Window/getScreenDetails

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API