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 + "%"); }