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.chargingRead only -
A Boolean value indicating whether the battery is currently being charged.
-
BatteryManager.chargingTimeRead 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.dischargingTimeRead only -
A number representing the remaining time in seconds until the battery is completely discharged and the system suspends.
-
BatteryManager.levelRead 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
chargingchangeevent; This event is sent when the battery charging state is updated. BatteryManager.onchargingtimechange-
A handler for the
chargingtimechangeevent; This event is sent when the battery charging time is updated BatteryManager.ondischargingtimechange-
A handler for the
dischargingtimechangeevent; This event is sent when the battery discharging time is updated. BatteryManager.onlevelchange-
A handler for the
levelchangeevent; This event is sent when the battery level is updated.
Methods
Inherits methods from its parent interface: EventTarget.
Specifications
| Specification |
|---|
| Battery Status API # the-batterymanager-interface |
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