API Battery Status

L'APIBattery Status, souvent mentionnée sous le nomBattery API (l'APIBattery), fournit des informations sur le niveau de charge du système et permet d'envoyer des événements pour prévenir d'un changement du niveau de charge de la batterie. Cela peut être utilisé pour ajuster la consommation d'une application et la réduire pour réduire l'utilisation de la batterie lorsque son niveau de charge est bas ou encore de sauvegarder les données quand la batterie est bientôt vide.

Note :Cette APIn'est pas disponible dans lesWeb Workers (elle n'est pas exposée viaWorkerNavigator).

Interfaces

BatteryManager: Fournit des informations sur le niveau de charge du système.
navigator.getBattery()Lecture seule: Renvoie un objetPromise dont la valeur de résolution est un objetBatteryManager.

Exemple

Dans cet exemple, on cherche à surveiller les changements, à la fois du statut de la charge (est-ce que l'équipement est branché et se recharge ou est ce que l'équipement est alimenté par sa batterie) et des changements du niveau de charge dans le temps. Cela se fait en surveillant les événementschargingchange,levelchange,chargingtimechange etdischargingtimechange.

navigator.getBattery().then((battery) => {  function updateAllBatteryInfo() {    updateChargeInfo();    updateLevelInfo();    updateChargingInfo();    updateDischargingInfo();  }  updateAllBatteryInfo();  battery.addEventListener("chargingchange", () => {    updateChargeInfo();  });  function updateChargeInfo() {    console.log("Battery en charge ? " + (battery.charging ? "Oui" : "Non"));  }  battery.addEventListener("levelchange", () => {    updateLevelInfo();  });  function updateLevelInfo() {    console.log("Niveau de batterie : " + battery.level * 100 + "%");  }  battery.addEventListener("chargingtimechange", () => {    updateChargingInfo();  });  function updateChargingInfo() {    console.log(      "Temps avant charge de la batterie : " +        battery.chargingTime +        " secondes",    );  }  battery.addEventListener("dischargingtimechange", () => {    updateDischargingInfo();  });  function updateDischargingInfo() {    console.log(      "Autonomie sur batterie : " + battery.dischargingTime + " secondes",    );  }});

Voir aussil'exemple de la spécification.