Resumo
A interface BatteryManager fornece maneiras de obter informações sobre o nível de carga da bateria do sistema.
A propriedade navigator.battery retorna uma instância da interface BatteryManager que você pode utilizar para interajir com a API de status da bateria.
Propriedades
BatteryManager.chargingSomente leitura-
Um valor Booleano que indica se a bateria está sendo carregada no momento.
BatteryManager.chargingTimeSomente leitura-
Um número representando o tempo restante em segundos até a bateria estar completamente carregada, ou 0 se a carga já estiver completa.
BatteryManager.dischargingTimeSomente leitura- Um número representando o tempo restante em segundos até a bateria estar completamente descarregada e o sistema ser suspenso.
BatteryManager.levelSomente leitura- Um número representando o nível de carga da bateria do sistema em uma escala de valores entre 0.0 e 1.0.
Eventos
BatteryManager.onchargingchange- Tratamento para o evento
chargingchange; Esse evento é enviado quando o status de carregamento da bateria é atualizado. BatteryManager.onchargingtimechange- Tratamento para o evento
chargingtimechange; Esse evento é enviado quando o tempo de carregamento da bateria é atualizado. BatteryManager.ondischargingtimechange- Tratamento para o evento
dischargingtimechange; Esse evento é enviado quando o tempo de descarregamento da bateria é atualizado. BatteryManager.onlevelchange- Tratamento para o evento
levelchange; Esse evento é enviado quando a nível da bateria é atualizado.
Métodos
Herdado de EventTarget:
Especificações
| Especificação | Status | Comentário |
|---|---|---|
| Battery Status API | Candidata a Recomendação | Especificação Inicial. |
Compatibilidade entre navegadores
Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!
| Funcionalidade | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Suporte básico | Não suportado Chrome para Android: crbug.com/135863 Chrome OS: crbug.com/122593 |
10 (10) moz [1] 16 (16) (sem prefixo) [2] |
Não suportado | Não suportado | Não suportado |
| Funcionalidade | Android | Chrome para Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Suporte básico | ? | Não suportado | 10.0 (10) moz [1] 16.0 (16) (sem prefixo) [2] |
Não suportado | Não suportado | Não suportado |
Notas para o Gecko
[1] Desabilitado por padrão no Firefox 10.0, mas pode ser habilitado alterando a preferência dom.battery.enabled para true. A partir do Firefox 11.0, mozBattery é habilitado por padrão.
[2] A Battery API é atualmente suportada no Android, Windows e Linux com UPower instalado. O suporte para MacOS está disponível a partir do Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15);