Navigator: getBattery() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die getBattery()-Methode liefert Informationen über den Akku des Systems. Sie gibt ein Battery Promise zurück, das mit einem BatteryManager-Objekt aufgelöst wird, das einige Eigenschaften zur Abfrage des Akkustatus sowie einige Ereignisse bereitstellt, die Sie verwenden können, um den Akkustatus zu überwachen. Dies implementiert die Battery Status API; siehe diese Dokumentation für weitere Details, einen Leitfaden zur Nutzung der API und Beispielcode.

Seit Chrome 103 wird die Navigator.getBattery() Methode der Battery Status API nur in sicheren Kontexten zur Verfügung gestellt.

Hinweis: Der Zugriff auf diese Funktion kann durch die Permissions-Policy-Direktive battery gesteuert werden.

Syntax

js
getBattery()

Parameter

Keine.

Rückgabewert

Ein Promise, der mit einem BatteryManager-Objekt erfüllt wird, das Sie verwenden können, um Informationen über den Zustand des Akkus zu erhalten.

Ausnahmen

NotAllowedError DOMException

Die Nutzung dieser Funktion wurde durch eine Permissions Policy blockiert.

SecurityError DOMException

Der User Agent gibt keine Batterieinformationen für unsichere Kontexte preis und diese Methode wurde von einem unsicheren Kontext aus aufgerufen.

Beispiele

Dieses Beispiel ruft den aktuellen Ladezustand der Batterie ab und richtet einen Handler für das chargingchange-Ereignis ein, sodass der Ladezustand immer dann aufgezeichnet wird, wenn er sich ändert.

js
let batteryIsCharging = false;

navigator.getBattery().then((battery) => {
  batteryIsCharging = battery.charging;

  battery.addEventListener("chargingchange", () => {
    batteryIsCharging = battery.charging;
  });
});

Für weitere Beispiele und Details siehe Battery Status API.

Spezifikationen

Specification
Battery Status API
# dom-navigator-getbattery

Browser-Kompatibilität

Siehe auch