Battery Status Plugin
This plugin provides an implementation of an old version of the Battery Status Events API. It adds the following three events to the
window
object:- batterystatus
- batterycritical
- batterylow
Applications may use
window.addEventListener
to attach an event listener for any of the above events after the deviceready
event fires.cordova-plugin-battery-status
All events in this plugin return an object with the following properties:
Property | Type | Description |
level | Number | The battery charge percentage ( 0-100 ) |
isPlugged | Boolean | Indicates whether the device is plugged in |
Fires when the battery charge percentage changes by at least
1 percent
, or when the device is plugged in or unplugged. Returns an object containing battery status.window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(status) {
console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
}
- iOS
- Android
The Android implementations are greedy and prolonged use will drain the device's battery.
Fires when the battery charge percentage reaches the low charge threshold. This threshold value is device-specific. Returns an object containing battery status.
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(status) {
alert("Battery Level Low " + status.level + "%");
}
- iOS
- Android
Fires when the battery charge percentage reaches the critical charge threshold. This threshold value is device-specific. Returns an object containing battery status.
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(status) {
alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}
- iOS
- Android
See Also:
Last modified 1yr ago