browser.power

Beschrijving

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

Rechten

power

Concepten en 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()

browser.power.releaseKeepAwake(): void

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

reportActivity()

Chrome 113+ browser.* sinds Chrome 148 Alleen ChromeOS 
browser.power.reportActivity(): 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.

Retourzendingen

  • Promise<void>

requestKeepAwake()

browser.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