Obsolete
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.
Indicates the amount of time, in seconds, that remains until the battery is fully discharged.
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.
Syntax
var time = battery.dischargingTime
On return, time
is the remaining time in seconds until the
battery
, which is a BatteryManager
object, is fully
discharged and the system will suspend. This value is
Infinity
if the battery is currently charging rather than discharging, or if the system is unable
to report the remaining discharging time.
Example
HTML Content
<div id="dischargingTime">(discharging time unknown)</div>
JavaScript Content
navigator.getBattery().then(function(battery) {
var time = battery.dischargingTime;
document.querySelector('#dischargingTime').textContent = battery.dischargingTime;
});
Specifications
Specification | Status | Comment |
---|---|---|
Battery Status API | Candidate Recommendation | Initial definition |
Browser compatibility
BCD tables only load in the browser