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.
A Boolean value indicating whether or not the device's battery is currently being charged.
Syntax
var charging = battery.charging
On return, charging
indicates whether or not the battery
, which is a BatteryManager
object, is currently being charged; if the battery is charging, this value is true
. Otherwise, the value is false
.
Example
HTML Content
<div id="charging">(charging state unknown)</div>
JavaScript Content
navigator.getBattery().then(function(battery) { var charging = battery.charging; document.querySelector('#charging').textContent = charging ; });
Specifications
Specification | Status | Comment |
---|---|---|
Battery Status API | Candidate Recommendation | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
charging | Chrome Full support 38 | Edge Full support 79 | Firefox
No support
16 — 52
| IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 40 | Chrome Android
Full support
38
| Firefox Android
No support
10 — 16
| Opera Android Full support 25 | Safari iOS No support ? — ? | Samsung Internet Android
Full support
3.0
|
Legend
- Full support
- Full support
- No support
- No support
- Deprecated. Not for use in new websites.
- Deprecated. Not for use in new websites.
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.