BatteryManager.level

Limited availability

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

La propriété BatteryManager.level indique le niveau de charge de la batterie en tant que valeur comprise entre 0.0 et 1.0. Une valeur de 0.0 signifie que la batterie est vide et que le système est sur le point d'être désactivé. Une valeur de 1.0 signifie que la batterie est pleine. La valeur 1.0 est aussi retournée si le système n'est pas capable de déterminer son niveau de charge ou si le système n'est pas alimenté par une batterie. Lorsque sa valeur change, l'évènement levelchange est déclenché.

Exemple

HTML

html

<button id="get-level">Obtenir le niveau de la batterie</button>
<div id="output"></div>

JavaScript

const getLevel = document.querySelector("#get-level");
const output = document.querySelector("#output");

getLevel.addEventListener("click", async () => {
  if (!navigator.getBattery) {
    output.textContent = "Le gestionnaire de batterie n'est pas pris en charge";
  } else {
    const manager = await navigator.getBattery();
    const level = manager.level;
    output.textContent = `Niveau de batterie : ${level}`;
  }
});

Résultat

Spécifications

Specification
Battery Status API # dom-batterymanager-level