WakeLock: метод request()

Метод request() интерфейса WakeLock возвращает Promise, который выполняется с объектом WakeLockSentinel, если системный экранный блокиратор пробуждения предоставлен.

Блокировка пробуждения экрана предотвращает затемнение или блокировку экранов устройств, когда приложение должно продолжать работу.

type Необязательно

Строка, определяющая тип блокировки пробуждения экрана из следующих перечисленных типов:

screen

Препятствует выключению экрана. Документы, которые видны, могут получить блокировку пробуждения экрана.

Если параметр type не указан явно, метод request() по умолчанию использует тип screen.

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

NotAllowedError DOMException

Выбрасывается, когда блокировка пробуждения недоступна, что может произойти по следующим причинам:

• Использование этой функции заблокировано политикой Политики разрешений.
• Документ не полностью активен.
• Состояние видимости документа равно hidden.
• Пользовательский агент не смог получить блокировку пробуждения платформы. Например, это может произойти, если у устройства низкий заряд батареи.

Следующая асинхронная функция запрашивает объект WakeLockSentinel. Метод request() заключён в оператор try...catch для обработки случаев, когда браузер отклоняет запрос по любой причине.

const requestWakeLock = async () => {
  try {
    const wakeLock = await navigator.wakeLock.request("screen");
  } catch (err) {
    // The wake lock request fails - usually system-related, such as low battery.

    console.log(`${err.name}, ${err.message}`);
  }
};

requestWakeLock();

Блокировка пробуждения экрана может быть отозвана устройством после того, как она была предоставлена. Возвращённый объект WakeLockSentinel может быть использован для проверки состояния блокировки и/или для ручного отмены удерживаемой блокировки пробуждения экрана.

• Оставайтесь активными с API блокировки пробуждения экрана