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.
EventTarget BatteryManager
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
Browser compatibility
Desktop
Mobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on IOS
Samsung Internet
WebView Android
BatteryManager
38
79
43–52
25
No
38
43–52
25
No
3.0
38
charging
38
79
43–52
25
No
38
43–52
25
No
3.0
38
chargingTime
38
79
43–52
25
No
4238–42 Always equal to 0
or Infinity
.
43–52
2925–29 Always equal to 0
or Infinity
.
No
4.03.0–4.0 Always equal to 0
or Infinity
.
4238–42 Always equal to 0
or Infinity
.
chargingchange_event
38
79
43–52
25
No
38
43–52
25
No
3.0
38
chargingtimechange_event
38
79
43–52
25
No
38
43–52
25
No
3.0
38
dischargingTime
38
79
43–52
25
No
4238–42 Always equal to Infinity
.
43–52
2925–29 Always equal to Infinity
.
No
4.03.0–4.0 Always equal to Infinity
.
4238–42 Always equal to Infinity
.
dischargingtimechange_event
38
79
43–52
25
No
38
43–52
25
No
3.0
38
level
38
79
43–52
25
No
38
43–52
25
No
3.0
38
levelchange_event
38
79
43–52
25
No
38
43–52
25
No
3.0
38
secure_context_required
103
103
No
No
No
103
No
71
No
20.0
103
See also