This plugin provides an implementation of an old version of the Battery Status Events API.
It adds the following three window events:
cordova plugin add org.apache.cordova.battery-status
This event fires when the percentage of battery charge changes by at least 1 percent, or if the device is plugged in or unplugged.
The battery status handler is passed an object that contains two properties:
level: The percentage of battery charge (0-100). (Number)
isPlugged: A boolean that indicates whether the device is plugged in. (Boolean)
Applications typically should use window.addEventListener to attach an event listener once the deviceready event fires. e.g.:
Windows Phone 7 does not provide native APIs to determine battery level, so the level property is unavailable. The isPlugged parameter is supported.
window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(info) {
// Handle the online event
console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
}
The event fires when the percentage of battery charge has reached the critical battery threshold. The value is device-specific.
The batterycritical handler is passed an object that contains two properties:
level: The percentage of battery charge (0-100). (Number)
isPlugged: A boolean that indicates whether the device is plugged in. (Boolean)
Applications typically should use window.addEventListener to attach an event listener once the deviceready event fires.
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(info) {
// Handle the battery critical event
alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
}
The event fires when the percentage of battery charge has reached the low battery threshold, device-specific value.
The batterylow handler is passed an object that contains two properties:
level: The percentage of battery charge (0-100). (Number)
isPlugged: A boolean that indicates whether the device is plugged in. (Boolean)
Applications typically should use window.addEventListener to attach an event listener once the deviceready event fires.
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(info) {
// Handle the battery low event
alert("Battery Level Low " + info.level + "%");
}