BatteryManager

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.

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

Specification
Battery Status API
# the-batterymanager-interface

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 42
38–42Always equal to 0 or Infinity.
 43–52 29
25–29Always equal to 0 or Infinity.
 No 4.0
3.0–4.0Always equal to 0 or Infinity.
 42
38–42Always 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 42
38–42Always equal to Infinity.
 43–52 29
25–29Always equal to Infinity.
 No 4.0
3.0–4.0Always equal to Infinity.
 42
38–42Always 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

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