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
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.
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
- Battery Status API
Permissions-Policy
battery
Direktive