chrome.power

refresh date: 2026-09-25 robots: noindex

Описание

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

Разрешения

power

Использование

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

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

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

Типы

Level

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

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

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

Методы

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

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

reportActivity()

Promise Chrome 113+ Только для ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

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

Параметры

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

requestKeepAwake()

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

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

Параметры