1. Tecnologia Web para desenvolvedores
  2. APIs da Web
  3. Battery Status API

Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

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.

js
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

api.Navigator.getBattery

Veja também

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

AltStyle によって変換されたページ (->オリジナル) /