BatteryManager
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The BatteryManager
interface of the Battery Status API provides information about the system's battery charge level. The navigator.getBattery()
method returns a promise that resolves with a BatteryManager
interface.
Since Chrome 103, the BatteryManager
interface of Battery Status API only expose to secure context.
Instance properties
Also inherits properties from its parent interface, EventTarget
.
BatteryManager.charging
Read only-
A Boolean value indicating whether the battery is currently being charged.
BatteryManager.chargingTime
Read only-
A number representing the remaining time in seconds until the battery is fully charged, or 0 if the battery is already fully charged.
BatteryManager.dischargingTime
Read only-
A number representing the remaining time in seconds until the battery is completely discharged and the system suspends.
BatteryManager.level
Read only-
A number representing the system's battery charge level scaled to a value between 0.0 and 1.0.
Instance methods
Also inherits methods from its parent interface, EventTarget
.
Events
Also inherits events from its parent interface, EventTarget
.
chargingchange
-
Fired when the battery charging state (the
charging
property) is updated. chargingtimechange
-
Fired when the battery charging time (the
chargingTime
property) is updated. dischargingtimechange
-
Fired when the battery discharging time (the
dischargingTime
property) is updated. levelchange
-
Fired when the battery level (the
level
property) is updated.
Specifications
Specification |
---|
Battery Status API # the-batterymanager-interface |
Browser compatibility
BCD tables only load in the browser