Spec-Zone.ru › Web APIs

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

См. также

  • Поддерживать экран включенным с помощью 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/WakeLock

Spec-Zone.ru

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