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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
BatteryManager
charging
chargingTime
chargingchange event
chargingtimechange event
dischargingTime
dischargingtimechange event
level
levelchange event
Secure context required
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Has more compatibility info.

See also