Obsolète
Cette fonctionnalité est obsolète. Bien qu'encore supportée par des navigateurs, son utilisation est découragée pour tout nouveau projet. Évitez de l'utiliser.
L'API Battery Status, souvent mentionnée sous le nom Battery API, 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.
L'API Battery Status API étend l'interface window.navigator
avec la propriété window.navigator.battery
, méthode qui renvoie une promesse, résolue par l'objet BatteryManager
. Cet objet permet d'ajouter des nouveaux événements pour superviser l'état de la batterie.
Exemples
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énements :
chargingchange
: changement de l'êtat de chargelevelchange
: changement du niveau de batteriechargingtimechange
: évolution de l'estimation du temps de rechargedischargingtimechange
: évolution de l'estimation d'autonomie sur batterie
navigator.getBattery().then(function(battery) {
function updateAllBatteryInfo(){
updateChargeInfo();
updateLevelInfo();
updateChargingInfo();
updateDischargingInfo();
}
updateAllBatteryInfo();
battery.addEventListener('chargingchange', function(){
updateChargeInfo();
});
function updateChargeInfo(){
console.log("Battery en charge ? "
+ (battery.charging ? "Oui" : "Non"));
}
battery.addEventListener('levelchange', function(){
updateLevelInfo();
});
function updateLevelInfo(){
console.log("Niveau de batterie: "
+ battery.level * 100 + "%");
}
battery.addEventListener('chargingtimechange', function(){
updateChargingInfo();
});
function updateChargingInfo(){
console.log("Temps avant charge de la batterie: "
+ battery.chargingTime + " secondes");
}
battery.addEventListener('dischargingtimechange', function(){
updateDischargingInfo();
});
function updateDischargingInfo(){
console.log("Autonomie sur batterie: "
+ battery.dischargingTime + " secondes");
}
});
Voir aussi l'exemple de la spécification.
Spécifications
Spécification | État | Commentaires |
---|---|---|
Battery Status API | Candidat au statut de recommandation | Définition initiale. |
Compatibilité des navigateurs
BCD tables only load in the browser