MDN self-hosted library · e01.org

BatteryManager

Battery API

no runnable cells web-api-interface upstream source

Battery API

The BatteryManager interface of the 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 only expose to secure context.

Instance properties

Also inherits properties from its parent interface, EventTarget.

  • BatteryManager.charging
  • : A Boolean value indicating whether the battery is currently being charged.
  • BatteryManager.chargingTime
  • : 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
  • : A number representing the remaining time in seconds until the battery is completely discharged and the system suspends.
  • BatteryManager.level
  • : 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

See also

  • The
  • Navigator.getBattery()