W3cubDocs

/Web APIs

BatteryManager: dischargingTime property

The BatteryManager.dischargingTime property 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

html

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

JavaScript

js

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

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

Specifications

Specification
Battery Status API
# dom-batterymanager-dischargingtime

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
dischargingTime 38 79 43–52 No 25 No 42
38–42Always equal to Infinity.
 42
38–42Always equal to Infinity.
 43–52 29
25–29Always equal to Infinity.
 No 4.0
3.0–4.0Always equal to Infinity.

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BatteryManager/dischargingTime