Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.
Battery Status API
A API Battery Status, mais conhecida como Battery API, fornece informações sobre o nível de carga da bateria presente no sistema e permite que você seja notificado por eventos que são enviados quando os níveis sofrem alterações. Isto pode ser usado para ajustar a utilização de recursos do seu aplicativo, reduzindo a quantidade de energia drenada por ele quando a bateria estiver em nível baixo, ou ainda para salvar mudanças antes da bateria acabar, prevenindo a perda de dados.
A API Battery Status API estende Window.navigator com uma propriedade Navigator.battery que é um objeto BatteryManager, e adiciona alguns novos eventos que você pode receber para monitorar o status da bateria.
Exemplo
Neste exemplo, nós observamos as mudanças em ambos os status de carregamento (se estamos ou não conectados e carregando) e para mudanças no nível da bateria. Isto é feito escutando pelos eventos chargingchange e levelchange, respectivamente.
var battery =
navigator.battery || navigator.mozBattery || navigator.webkitBattery;
function updateBatteryStatus() {
console.log("Status da bateria: " + battery.level * 100 + " %");
if (battery.charging) {
console.log("A bateria está carregando");
}
}
battery.addEventListener("chargingchange", updateBatteryStatus);
battery.addEventListener("levelchange", updateBatteryStatus);
updateBatteryStatus();
Veja também o exemplo na especificação.
Especificações
| Specification |
|---|
| Battery Status API> |
Compatibilidade com navegadores
>api.BatteryManager
Loading...
api.Navigator.getBattery
Loading...