BatteryManager

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

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.

Properties

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.

Event handlers

BatteryManager.onchargingchange

A handler for the chargingchange event; This event is sent when the battery charging state is updated.

BatteryManager.onchargingtimechange

A handler for the chargingtimechange event; This event is sent when the battery charging time is updated

BatteryManager.ondischargingtimechange

A handler for the dischargingtimechange event; This event is sent when the battery discharging time is updated.

BatteryManager.onlevelchange

A handler for the levelchange event; This event is sent when the battery level is updated.

Methods

Inherits methods from its parent interface: EventTarget.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
BatteryManager
38
79
43-52
No
25
No
38
38
43-52
25
No
3.0
charging
38
79
43-52
No
25
No
38
38
43-52
25
No
3.0
chargingTime
38
79
43-52
No
25
No
42
38-42
Always equal to 0 or Infinity.
42
38-42
Always equal to 0 or Infinity.
43-52
29
25-29
Always equal to 0 or Infinity.
No
4.0
3.0-4.0
Always equal to 0 or Infinity.
dischargingTime
38
79
43-52
No
25
No
42
38-42
Always equal to Infinity.
42
38-42
Always equal to Infinity.
43-52
29
25-29
Always equal to Infinity.
No
4.0
3.0-4.0
Always equal to Infinity.
level
38
79
43-52
No
25
No
38
38
43-52
25
No
3.0
onchargingchange
38
79
43-52
No
25
No
38
38
43-52
25
No
3.0
onchargingtimechange
38
79
43-52
No
25
No
38
38
43-52
25
No
3.0
ondischargingtimechange
38
79
43-52
No
25
No
38
38
43-52
25
No
3.0
onlevelchange
38
79
43-52
No
25
No
38
38
43-52
25
No
3.0

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BatteryManager