Battery Status Plugin
Tested Version: 2.0.3
Plugin ID
cordova-plugin-battery-status
Adding the Plugin
In order to use this plugin, please enable Battery
plugin in Monaca Cloud IDE.
API Reference
Status object
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
batterystatus event
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.
Example
window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(status) {
console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
}
Supported Platforms
iOS
Android
Quirks: Android
batterylow event
Fires when the battery charge percentage reaches the low charge threshold. This threshold value is device-specific. Returns an object containing battery status.
Example
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(status) {
alert("Battery Level Low " + status.level + "%");
}
Supported Platforms
iOS
Android
batterycritical event
Fires when the battery charge percentage reaches the critical charge threshold. This threshold value is device-specific. Returns an object containing battery status.
Example
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(status) {
alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}
Supported Platforms
iOS
Android
See Also:
Last updated
Was this helpful?