---
title: Battery Status API
slug: Web/API/Battery_Status_API
tags:
  - API
  - Apps
  - Batería
  - Firefox OS
  - Guia(2)
  - Guía
  - Mobile
  - Obsoleto
translation_of: Web/API/Battery_Status_API
original_slug: WebAPI/Battery_Status
---
<div>{{obsolete_header}}</div>

<div>{{DefaultAPISidebar("Battery API")}}</div>

<p>A <strong>API Battery Status</strong>, mais conhecida como <strong>Battery API</strong>, 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.</p>

<p>A API Battery Status API estende {{domxref("Window.navigator")}} com uma propriedade {{domxref("Navigator.battery")}} que é um objeto {{domxref("BatteryManager")}},  e adiciona alguns novos eventos que você pode receber para monitorar o status da bateria.</p>

<h2 id="Exemplo">Exemplo</h2>

<p>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 {{event("chargingchange")}} e {{event("levelchange")}}, respectivamente.</p>

<pre class="brush: 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();
</pre>

<p>Veja também <a class="external" href="http://dev.w3.org/2009/dap/system-info/battery-status.html#introduction">o exemplo na especificação</a>.</p>

<h2 id="Especificações">Especificações</h2>

<p>{{page("/pt-BR/docs/Web/API/BatteryManager","Specifications")}}</p>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{page("/pt-BR/docs/Web/API/BatteryManager","Browser_compatibility")}}</p>

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li><a class="external" href="http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/">Hacks blog post - Usando a API Battery API (em inglês)</a></li>
 <li>{{domxref("BatteryManager")}}</li>
 <li>{{domxref("Navigator.battery","navigator.battery")}}</li>
</ul>