browser.power

Описание

Используйте API chrome.power, чтобы переопределить системные функции управления питанием.

Разрешения

power

Основные понятия и использование

По умолчанию операционные системы затемняют экран, когда пользователи неактивны, и в конечном итоге приостанавливают работу системы. С помощью Power API приложение или расширение может не давать системе перейти в спящий режим.

С помощью этого API можно указать уровень, на котором управление питанием будет отключено. Уровень "system" позволяет системе работать, но экран может быть затемнен или выключен. Например, приложение для общения может продолжать получать сообщения, когда экран выключен. Уровень "display" позволяет экрану и системе работать. Например, приложения для чтения электронных книг и просмотра презентаций могут поддерживать экран и систему в активном состоянии, пока пользователи читают.

Если у пользователя активно несколько приложений или расширений, у каждого из которых свой уровень энергопотребления, то применяется уровень с наивысшим приоритетом. "display" всегда имеет приоритет над "system". Например, если приложение А запрашивает управление питанием "system", а приложение Б – "display", то используется "display", пока приложение Б не будет выгружено или не отменит свой запрос. Если приложение A все ещё активно, используется "system".

Типы

Level

Перечисление

"system"
Запрещает системе переходить в спящий режим, если пользователь неактивен.

"display"
Предотвращает отключение или затемнение экрана, а также переход системы в спящий режим в случае бездействия пользователя.

Методы

releaseKeepAwake()

browser.power.releaseKeepAwake(): void

Отменяет запрос, ранее сделанный с помощью requestKeepAwake().

reportActivity()

Chrome 113+ browser.* начиная с Chrome 148 Только ChromeOS 
browser.power.reportActivity(): Promise<void>

Сообщает о действиях пользователя, чтобы вывести экран из режима заставки, затемнения или отключения. Выход из заставки, если она активна.

Возвраты

  • Promise<void>

requestKeepAwake()

browser.power.requestKeepAwake(
  level: Level,
): void

Запрашивает временное отключение управления питанием. level описывает, в какой степени должно быть отключено управление питанием. Если запрос, ранее сделанный тем же приложением, все ещё активен, он будет заменен новым.

Параметры