BatteryManager: level property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{ApiRef("Battery API")}}{{securecontext_header}}
The **level** read-only property of the {{domxref("BatteryManager")}} interface indicates the current battery charge level as a value between 0.0 and 1.0. A value of 0.0 means the battery is empty and the system is about to be suspended. A value of 1.0 means the battery is full or the user agent is unable to report the battery status information. When its value changes, the {{domxref("BatteryManager/levelchange_event", "levelchange")}} event is fired.
Value
A number.
Examples
Getting the battery level
HTML
html
<button id="get-level">Get battery level</button>
<div id="output"></div>JavaScript
js
const getLevel = document.querySelector("#get-level");
const output = document.querySelector("#output");
getLevel.addEventListener("click", async () => {
if (!navigator.getBattery) {
output.textContent = "Battery manager is unsupported";
} else {
const manager = await navigator.getBattery();
const level = manager.level;
output.textContent = `Battery level: ${level}`;
}
});Result
{{ EmbedLiveSample('Getting the battery level') }}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("BatteryManager")}}
- {{domxref("Navigator.getBattery()")}}