chrome.power

refresh date: 2026-09-25 robots: noindex

Description

Utilisez l'API chrome.power pour ignorer les fonctionnalités de gestion de l'alimentation du système.

Autorisations

power

Utilisation

Par défaut, les systèmes d'exploitation assombrissent l'écran lorsque les utilisateurs sont inactifs et finissent par suspendre le système. L'API Power permet à une application ou à une extension de maintenir le système actif.

Cette API vous permet de spécifier le niveau auquel la gestion de l'alimentation est désactivée. Le niveau "system" maintient le système actif, mais permet d'assombrir ou d'éteindre l'écran. Par exemple, une application de communication peut continuer à recevoir des messages lorsque l'écran est éteint. Le niveau "display" maintient l'écran et le système actifs. Par exemple, les applications d'e-books et de présentation peuvent maintenir l'écran et le système actifs pendant que les utilisateurs lisent.

Lorsqu'un utilisateur dispose de plusieurs applications ou extensions actives, chacune avec son propre niveau de puissance, le niveau de priorité le plus élevé prend effet : "display" est toujours prioritaire sur "system". Par exemple, si l'application A demande la gestion de l'alimentation "system" et que l'application B demande "display", "display" est utilisé jusqu'à ce que l'application B soit déchargée ou qu'elle libère sa requête. Si l'application A est toujours active, "system" est alors utilisé.

Types

Level

Énumération

"system"
Empêche le système de se mettre en veille en cas d'inactivité de l'utilisateur.

"display"
Empêche l'écran de s'éteindre ou de s'assombrir, ou le système de se mettre en veille en cas d'inactivité de l'utilisateur.

Méthodes

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Libère une requête précédemment effectuée via requestKeepAwake().

reportActivity()

Promise Chrome 113+ ChromeOS uniquement 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

Signale une activité de l'utilisateur afin de réactiver l'écran s'il est assombri ou éteint, ou s'il affiche un économiseur d'écran. Quitte l'économiseur d'écran s'il est actuellement actif.

Paramètres

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

requestKeepAwake()

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

Demande la désactivation temporaire de la gestion de l'alimentation. level décrit le degré de désactivation de la gestion de l'alimentation. Si une requête précédemment effectuée par la même application est toujours active, elle sera remplacée par la nouvelle requête.

Paramètres