ObsoleteThis 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 38 |
Edge
Full support 79 |
Firefox No support 16 — 52 No support 16 — 52 No support 10 — 16 Prefixed' Implemented with the vendor prefix: moz Full support 52 Notes' Disabled by default in Firefox 10, but can be enabled setting the preference Notes' From this version onwards, |
IE
No support No |
Opera
Full support 25 |
Safari
No support No |
WebView Android
Full support 40 |
Chrome Android Full support 38 Full support 38 Notes' Values for |
Firefox Android No support 10 — 16 No support 10 — 16 Prefixed' Implemented with the vendor prefix: moz No support 16 — 52 Notes' Disabled by default in Firefox 10.0, but can be enabled setting the preference |
Opera Android
Full support 25 |
Safari iOS
No support ? — ? |
Samsung Internet Android Full support 3.0 Full support 3.0 Notes' Values for |
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.
See also
BatteryManager.charging by Mozilla Contributors is licensed under CC-BY-SA 2.5.