chrome.power

refresh date: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.power API om de energiebeheerfuncties van het systeem te overschrijven.

Rechten

power

Gebruik

Besturingssystemen dimmen standaard het scherm als gebruikers inactief zijn en onderbreken uiteindelijk het systeem. Met de Power API kan een app of extensie het systeem actief houden.

Met deze API kun je het niveau aangeven waarop energiebeheer uitstaat. Het niveau "system" houdt het systeem actief, maar staat toe dat het scherm wordt gedimd of uitgezet. Een communicatie-app kan bijvoorbeeld berichten blijven ontvangen terwijl het scherm uitstaat. Het niveau "display" houdt het scherm en het systeem actief. E-book- en presentatie-apps kunnen bijvoorbeeld het scherm en het systeem actief houden terwijl gebruikers lezen.

Als een gebruiker meer dan één app of extensie actief heeft, elk met een eigen energieniveau, wordt het niveau met de hoogste prioriteit van kracht. "display" heeft altijd voorrang op "system". Als app A bijvoorbeeld vraagt om energiebeheer "system" en app B vraagt om "display", wordt "display" gebruikt totdat app B wordt verwijderd of het verzoek vrijgeeft. Als app A nog actief is, wordt "system" gebruikt.

Typen

Level

Enum

"system"
Voorkomt dat het systeem in de slaapstand gaat als de gebruiker inactief is.

"display"
Voorkomt dat het scherm wordt uitgezet of gedimd of dat het systeem in de slaapstand gaat als de gebruiker inactief is.

Methoden

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Geeft een verzoek vrij dat eerder is gedaan via requestKeepAwake().

reportActivity()

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

Rapporteert een gebruikersactiviteit om het scherm te activeren vanuit een gedimde of uitgeschakelde status of vanuit een screensaver. Sluit de screensaver als deze actief is.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

requestKeepAwake()

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

Verzoekt om energiebeheer tijdelijk uit te zetten. level beschrijft de mate waarin energiebeheer moet worden uitgezet. Als een eerder verzoek van dezelfde app nog actief is, wordt dit vervangen door het nieuwe verzoek.

Parameters