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 die Batterie des Systems. Sie gibt ein Batterie-Promise zurück, das mit einem BatteryManager Objekt aufgelöst wird. Dieses Objekt bietet einige Eigenschaften, um den Batteriestatus abzurufen, sowie einige Ereignisse, die Sie handhaben können, um den Batteriestatus zu überwachen. Dies implementiert die Battery Status API; sehen Sie in dieser Dokumentation für weitere Details, einen Leitfaden zur Verwendung der API und Beispielcode nach.

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 kontrolliert werden.

Syntax

js
getBattery()

Parameter

Keine.

Rückgabewert

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

Ausnahmen

NotAllowedError DOMException

Die Nutzung dieser Funktion wurde durch eine Permissions Policy blockiert.

SecurityError DOMException

Der User-Agent gibt keine Batterieinformationen an unsichere Kontexte weiter und diese Methode wurde von einem unsicheren Kontext aus aufgerufen.

Beispiele

Dieses Beispiel ruft den aktuellen Ladevorgang der Batterie ab und richtet einen Handler für das chargingchange Ereignis ein, sodass der Ladevorgang aufgezeichnet wird, wann immer 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

BCD tables only load in the browser

Siehe auch