W3cubDocs

/Web APIs

BatteryManager: chargingTime property

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 chargingTime read-only property of the BatteryManager interface indicates the amount of time, in seconds, that remain until the battery is fully charged, or 0 if the battery is already fully charged or the user agent is unable to report the battery status information. If the battery is currently discharging, its value is Infinity. When its value changes, the chargingtimechange 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="chargingTime">(charging time unknown)</div>

JavaScript

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

  document.querySelector("#chargingTime").textContent =
    `Time to fully charge the battery: ${time}s`;
});

Specifications

Specification
Battery Status API> # dom-batterymanager-chargingtime>

Browser compatibility

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