chrome.power

Aktualisierungsdatum: 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, wenn Nutzer inaktiv sind, und fahren das System schließlich herunter. Mit der Power API kann eine App oder Erweiterung das System aktiv halten.

Mit dieser API können Sie die Ebene angeben, auf der die Energieverwaltung deaktiviert wird. Auf der "system"-Ebene bleibt das System aktiv, das Display kann aber gedimmt oder deaktiviert werden. So kann eine Kommunikations-App beispielsweise weiterhin Nachrichten empfangen, während das Display deaktiviert ist. Auf der "display"-Ebene bleiben 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 aktiviert hat, gilt die Stufe mit der höchsten Priorität. "display" hat immer Vorrang vor "system". Wenn App A beispielsweise "system"-Energieverwaltung anfordert und App B "display", wird "display" verwendet, bis App B entladen wird oder die Anfrage freigibt. Wenn App A noch aktiv ist, wird "system" verwendet.

Typen

Level

Enum

„system“
Verhindert, dass das System aufgrund von Nutzerinaktivität in den Ruhemodus wechselt.

„display“
Verhindert, dass das Display aufgrund von Nutzerinaktivität ausgeschaltet oder gedimmt wird oder das System in den Ruhemodus wechselt.

Methoden

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Gibt eine zuvor über requestKeepAwake() gestellte Anfrage frei.

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, falls er gerade aktiv ist.

Parameter

  • callback

    Funktion 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

Anfragen, die die vorübergehende Deaktivierung der Energieverwaltung anfordern. level beschreibt, in welchem Maße die Energieverwaltung deaktiviert werden soll. Wenn eine zuvor von derselben App gestellte Anfrage noch aktiv ist, wird sie durch die neue Anfrage ersetzt.

Parameter