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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
getBattery
Secure context required
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch