Specifies an event listener to receive levelchange events. These events occur when the battery level is updated.
Syntax
navigator.battery.onlevelchange = funcRef
Where battery is a BatteryManager object, and funcRef is a function to be called when the levelchange event occurs.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Battery Status API | Working Draft | Last Call Working Draft. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 38 | Supports the deprecated navigator.battery.10 (10) moz [1] 16 (16) (without prefix) [2] |
Not supported | 25 | Not supported |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | Not supported | 39 [3] |
Supports the deprecated |
Not supported | 25 [3] | Not supported |
Notes
[1] Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default.
[2] The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15).
[3] Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity.