BatteryManager

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

BCD tables only load in the browser

See also