WakeLock
Безопасный контекст: Данная функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.
Интерфейс WakeLock API блокировки экрана может быть использован для запроса блокировки, которая предотвращает затемнение или блокировку экрана устройства, когда приложение нуждается в непрерывной работе.
Этот интерфейс, а следовательно, и блокировка системы, доступен через свойство Navigator.wakeLock.
Методы экземпляра
request()-
Возвращает
Promise, который выполняется с объектомWakeLockSentinel, если блокировка экрана предоставлена.
Примеры
Следующий код awaits запрос на объект WakeLockSentinel, и продолжает выполнение, если запрос удовлетворён.
Метод WakeLock.request() заключён в оператор try...catch для перехвата случаев, когда промис может быть отклонен, таких как низкая мощность устройства.
try {
const wakeLock = await navigator.wakeLock.request("screen");
} catch (err) {
// the wake lock request fails - usually system related, such being low on battery
console.log(`${err.name}, ${err.message}`);
}
Обратите внимание, что блокировка экрана может быть аннулирована устройством после её предоставления. Возвращаемый WakeLockSentinel может быть использован для проверки состояния блокировки и/или для отмены удерживаемой блокировки экрана вручную.
Спецификации
| Спецификация |
|---|
| API блокировки экрана # the-wakelock-interface |
Совместимость с браузерами
| Рабочий стол | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
WakeLock |
84 | 84 | 126 | 70 | 16.4 | 84 | 126 | 60 | 16.4Не работает в автономных приложениях домашнего экрана. См. баг 254545. |
14.0 | 84 |
request |
84 | 84 | 126 | 70 | 16.4 | 84 | 126 | 60 | 16.4Не работает в автономных приложениях домашнего экрана. См. баг 254545. |
14.0 | 84 |
См. также
© 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/WakeLock