chrome.power

refresh date: 2026-09-25 robots: noindex

Beschreibung

Verwenden Sie die chrome.power API, um die Energieverwaltungsfunktionen des Systems zu überschreiben.

Berechtigungen

power

Nutzung

Standardmäßig dimmen Betriebssysteme den Bildschirm bei Inaktivität und versetzen das System schließlich in den Ruhezustand. Mit der Power API kann eine App oder Erweiterung das System aktiv halten.

Mit dieser API können Sie die Stufe angeben, bis zu der die Energieverwaltung deaktiviert ist. Die Stufe "system" hält das System aktiv, ermöglicht aber, dass das Display gedimmt oder ausgeschaltet wird. Beispielsweise kann eine Kommunikations-App weiterhin Nachrichten empfangen, während das Display ausgeschaltet ist. Die Stufe "display" hält das Display und das System aktiv. E-Book- und Präsentations-Apps können beispielsweise den Bildschirm und das System aktiv halten, während Nutzer lesen.

Wenn ein Nutzer mehrere Apps oder Erweiterungen mit jeweils eigener Leistungsstufe aktiv hat, wird die Stufe mit der höchsten Priorität angewendet. "display" hat immer Vorrang vor "system". Wenn beispielsweise App A die Energieverwaltung "system" und App B die Energieverwaltung "display" anfordert, wird "display" verwendet, bis App B entladen wird oder die Anforderung freigibt. Wenn App A noch aktiv ist, wird "system" verwendet.

Typen

Level

Enum

"system"
Verhindert, dass das System bei Inaktivität des Nutzers in den Ruhemodus wechselt.

"display"
Verhindert, dass das Display ausgeschaltet oder gedimmt wird oder das System in den Ruhemodus wechselt, wenn der Nutzer inaktiv ist.

Methoden

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Gibt eine Anfrage frei, die zuvor über requestKeepAwake() gestellt wurde.

reportActivity()

Promise Chrome 113 und höher Nur ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

Meldet eine Nutzeraktivität, um den Bildschirm aus einem gedimmten oder ausgeschalteten Zustand oder aus einem Bildschirmschoner zu aktivieren. Beendet den Bildschirmschoner, wenn er gerade aktiv ist.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

requestKeepAwake()

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

Fordert an, dass die Energieverwaltung vorübergehend deaktiviert wird. level beschreibt, in welchem Umfang die Energieverwaltung deaktiviert werden soll. Wenn eine zuvor von derselben App gestellte Anfrage noch aktiv ist, wird sie durch die neue Anfrage ersetzt.

Parameter