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()")}}