--- title: BatteryManager slug: Web/API/BatteryManager tags: - API - Battery API - Referencia translation_of: Web/API/BatteryManager ---

{{APIRef("Battery API")}}

Resumo

A interface BatteryManager fornece maneiras de obter informações sobre o nível de carga da bateria do sistema.

A propriedade {{domxref("Navigator.battery","navigator.battery")}} retorna uma instância da interface BatteryManager que você pode utilizar para interajir com a API de status da bateria.

Propriedades

{{domxref("BatteryManager.charging")}} {{ReadOnlyInline}}

Um valor Booleano que indica se a bateria está sendo carregada no momento.

{{domxref("BatteryManager.chargingTime")}} {{ReadOnlyInline}}

Um número representando o tempo restante em segundos até a bateria estar completamente carregada, ou 0 se a carga já estiver completa.

{{domxref("BatteryManager.dischargingTime")}} {{ReadOnlyInline}}
Um número representando o tempo restante em segundos até a bateria estar completamente descarregada e o sistema ser suspenso.
{{domxref("BatteryManager.level")}} {{ReadOnlyInline}}
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

{{domxref("BatteryManager.onchargingchange")}}
Tratamento para o evento {{event("chargingchange")}}; Esse evento é enviado quando o status de carregamento da bateria é atualizado.
{{domxref("BatteryManager.onchargingtimechange")}}
Tratamento para o evento {{event("chargingtimechange")}}; Esse evento é enviado quando o tempo de carregamento da bateria é atualizado.
{{domxref("BatteryManager.ondischargingtimechange")}}
Tratamento para o evento {{event("dischargingtimechange")}}; Esse evento é enviado quando o tempo de descarregamento da bateria é atualizado.
{{domxref("BatteryManager.onlevelchange")}}
Tratamento para o evento {{event("levelchange")}}; Esse evento é enviado quando a nível da bateria é atualizado.

Métodos

Herdado de {{domxref("EventTarget")}}:

{{page("/pt-BR/docs/Web/API/EventTarget","Métodos")}}

Especificações

Especificação Status Comentário
{{SpecName('Battery API')}} {{Spec2('Battery API')}} Especificação Inicial.

Compatibilidade com navegadores

{{ CompatibilityTable() }}

Funcionalidade Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico {{ CompatNo() }}
Chrome para Android: crbug.com/135863
Chrome OS: crbug.com/122593
{{CompatGeckoDesktop("10")}} {{ property_prefix("moz") }} [1]
{{CompatGeckoDesktop("16")}} (sem prefixo) [2]
{{ CompatNo() }} {{ CompatNo() }} {{ CompatNo() }}
Funcionalidade Android Chrome para Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico {{ CompatUnknown() }} {{ CompatNo() }} {{CompatGeckoMobile("10")}} {{ property_prefix("moz") }} [1]
{{CompatGeckoMobile("16")}} (sem prefixo) [2]
{{ CompatNo() }} {{ CompatNo() }} {{ CompatNo() }}

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 {{geckoRelease("18.0")}};

Veja também