хром.мощность

дата обновления: 2026-09-25 robots: noindex

Описание

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

Разрешения

power

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

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

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

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

Типы

Level

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

"система"
Предотвращает переход системы в спящий режим в ответ на бездействие пользователя.

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

Методы

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

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

reportActivity()

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

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

Параметры

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

requestKeepAwake()

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

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

Параметры