# Battery Level
Device's battery level.
# Manifest Declaration
You need to declare the use of this API in the manifest's features
member:
{"name": "system.battery"}
# Module Import
Before using this service in a component, you need to import the module in the script section of the UX document.
import battery from '@system.battery'
Or
let battery = require("@system.battery")
# Methods
This service has the following method:
# getStatus({success,fail,complete})
This method gets the battery level of the current device.
# Arguments
This method requires an object
with the following attributes:
success
(function(res)
). Optional callback function for success, with the following arguments:res.charging
(boolean
): flag that indicates if the battery is being charged.res.level
(number
): Current battery level (values from0.0
to1.0
).
fail
(function(code)
). Optional callback function for failure.complete
(function()
). Optional callback function for completion.
Example:
battery.getStatus({
success(res) {
console.log(`level: ${res.level}`);
}
})