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 Batteriezustand des Systems. Sie gibt ein Batterie-Versprechen zurück, das mit einem BatteryManager Objekt auflöst, welches einige Eigenschaften bereitstellt, um den Batteriestatus zu ermitteln, und einige Ereignisse, die Sie abhandeln können, um den Batteriestatus zu überwachen. Dies implementiert die Battery Status API; siehe diese Dokumentation für zusätzliche Details, einen Leitfaden zur Verwendung 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, das mit einem BatteryManager Objekt erfüllt wird, welches zur Abfrage des Batterie-Zustandes verwendet werden kann.

Ausnahmen

NotAllowedError DOMException

Die Nutzung dieser Funktion wurde durch eine Permissions Policy blockiert.

SecurityError DOMException

Der Benutzeragent stellt keine Batterieinformationen in unsicheren Kontexten zur Verfügung, und diese Methode wurde aus einem unsicheren Kontext aufgerufen.

Beispiele

Dieses Beispiel ermittelt den aktuellen Ladezustand der Batterie und richtet einen Handler für das chargingchange Ereignis ein, sodass der Ladezustand immer dann erfasst 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