browser.power

Descrição

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

Permissões

power

Conceitos e uso

Por padrão, os sistemas operacionais escurecem a tela quando os usuários estão inativos e, por fim, suspendem o sistema. Com a API de energia, 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 ativo, cada um com o 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 solicitar o gerenciamento de energia "system" e o app B solicitar "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 suspensão em resposta à inatividade do usuário.

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

Métodos

releaseKeepAwake()

browser.power.releaseKeepAwake(): void

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

reportActivity()

Chrome 113+ browser.* desde o Chrome 148 Somente ChromeOS 
browser.power.reportActivity(): Promise<void>

Informa uma atividade do usuário para ativar a tela que está escurecida, desligada ou com um protetor de tela. Sai do protetor de tela se ele estiver ativo.

Retorna

  • Promessa<void>

requestKeepAwake()

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

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

Parâmetros