BatteryManager: level-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte level-Eigenschaft des BatteryManager-Interfaces gibt den aktuellen Ladezustand der Batterie als einen Wert zwischen 0.0 und 1.0 an. Ein Wert von 0.0 bedeutet, dass die Batterie leer ist und das System kurz vor dem Aussetzen steht. Ein Wert von 1.0 bedeutet, dass die Batterie voll ist oder der User-Agent nicht in der Lage ist, Informationen zum Batteriestatus zu berichten. Wenn sich ihr Wert ändert, wird das levelchange-Ereignis ausgelöst.

Wert

Eine Zahl.

Beispiele

Den Batteriestand abrufen

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}`;
  }
});

Ergebnis

Spezifikationen

Specification
Battery Status API
# dom-batterymanager-level

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch