Окно: метод getScreenDetails()
Ограниченная доступность
Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.
Экспериментально: Это экспериментальная технология экспериментальная технология
Перед использованием в рабочей среде тщательно проверьте таблицу совместимости браузеров таблицу совместимости браузеров.
Безопасный контекст: Данная функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих поддерживающих браузерах.
Метод getScreenDetails() интерфейса Window возвращает Promise, который завершается объектом ScreenDetails, представляющим данные обо всех доступных экранах устройства пользователя.
Синтаксис
getScreenDetails()
Параметры
Нет.
Возвращаемое значение
Promise, который завершается объектом ScreenDetails.
Исключения
-
NotAllowedErrorDOMException -
Выбрасывается, если задан
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}`,
);
}
Примечание: См. Многооконную учебную среду для полного примера (также см. исходный код).
Спецификации
Совместимость браузеров
| Рабочий стол | Мобильный | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
См. также
© 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