BatteryManager: charging property

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The charging read-only property of the BatteryManager interface is a Boolean value indicating whether or not the device's battery is currently being charged. When its value changes, the chargingchange event is fired.

If the battery is charging or the user agent is unable to report the battery status information, this value is true. Otherwise, it is false.

Value

A boolean.

Examples

HTML

html
<div id="charging">(charging state unknown)</div>

JavaScript

js
navigator.getBattery().then((battery) => {
  const charging = battery.charging;

  document.querySelector("#charging").textContent = charging;
});

Specifications

Specification
Battery Status API
# dom-batterymanager-charging

Browser compatibility

BCD tables only load in the browser

See also