chrome.power

Descrição

Use a API chrome.power para substituir os recursos de gerenciamento de energia do sistema.

Permissões

power

Uso

Por padrão, os sistemas operacionais escurecem a tela quando os usuários ficam inativos e acabam suspendendo o sistema. Com a API Power, um app ou uma extensão pode manter o sistema ativo.

Com essa API, é possível especificar o nível em que o gerenciamento de energia é desativado. O nível "system" mantém o sistema ativo, mas permite que a tela seja escurecida ou desligada. Por exemplo, um app de comunicação pode continuar recebendo mensagens enquanto a tela está desligada. O nível "display" mantém a tela e o sistema ativos. Por exemplo, apps de e-books e apresentações podem manter a tela e o sistema ativos enquanto os usuários leem.

Quando um usuário tem mais de um app ou extensão ativos, cada um com seu próprio nível de energia, o nível de maior precedência entra em vigor. "display" sempre tem precedência sobre "system". Por exemplo, se o app A pedir gerenciamento de energia "system" e o app B pedir "display", "display" será usado até que o app B seja descarregado ou libere a solicitação. Se o app A ainda estiver ativo, "system" será usado.

Tipos

Level

Enumeração

"system"
Impede que o sistema entre em modo de espera em resposta à inatividade do usuário.

"display"
Impede que a tela seja desligada ou escurecida, ou que o sistema entre em modo de suspensão em resposta à inatividade do usuário.

Métodos

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Libera uma solicitação feita anteriormente usando requestKeepAwake().

reportActivity()

Promise Chrome 113 ou mais recente Somente no ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

Informa uma atividade do usuário para ativar a tela de um estado escurecido ou desligado ou de um protetor de tela. Sai do protetor de tela se ele estiver ativo.

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<void>

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

requestKeepAwake()

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

Solicita que o gerenciamento de energia seja temporariamente desativado. level descreve o grau em que o gerenciamento de energia deve ser desativado. Se uma solicitação feita anteriormente pelo mesmo app ainda estiver ativa, ela será substituída pela nova.

Parâmetros