MDN self-hosted library · e01.org

BatteryManager: dischargingTime property

Battery API

Open notebook · 2 cells web-api-instance-property upstream source

Battery API

The dischargingTime read-only property of the BatteryManager interface indicates the amount of time, in seconds, that remains until the battery is fully discharged, or Infinity if the battery is currently charging rather than discharging or the user agent is unable to report the battery status information. When its value changes, the dischargingtimechange event is fired.

[!NOTE] Even if the time returned is precise to the second, browsers round them to a higher interval (typically to the closest 15 minutes) for privacy reasons.

Value

A number.

Examples

HTML

<div id="dischargingTime">(discharging time unknown)</div>

JavaScript

navigator.getBattery().then((battery) => {
  const time = battery.dischargingTime;

  document.querySelector("#dischargingTime").textContent =
    `Remaining time to fully discharge the battery: ${time}s`;
});

100%

Specifications

Browser compatibility

See also

  • BatteryManager
  • Navigator.getBattery()