aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/api/batterymanager/index.html
blob: b3ef26bc8acc9e50709014143ddec43afaebe2da (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
---
title: BatteryManager
slug: Web/API/BatteryManager
tags:
  - API
  - Battery API
  - Referencia
translation_of: Web/API/BatteryManager
---
<p>{{APIRef("Battery API")}}</p>

<h2 id="Resumo">Resumo</h2>

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

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

<h2 id="Propriedades">Propriedades</h2>

<dl>
 <dt>{{domxref("BatteryManager.charging")}} {{ReadOnlyInline}}</dt>
 <dd>
 <p>Um valor Booleano que indica se a bateria está sendo carregada no momento.</p>
 </dd>
 <dt>{{domxref("BatteryManager.chargingTime")}} {{ReadOnlyInline}}</dt>
 <dd>
 <p>Um número representando o tempo restante em segundos até a bateria estar completamente carregada, ou 0 se a carga já estiver completa.</p>
 </dd>
 <dt>{{domxref("BatteryManager.dischargingTime")}} {{ReadOnlyInline}}</dt>
 <dd>Um número representando o tempo restante em segundos até a bateria estar completamente descarregada e o sistema ser suspenso.</dd>
 <dt>{{domxref("BatteryManager.level")}} {{ReadOnlyInline}}</dt>
 <dd>Um número representando o nível de carga da bateria do sistema em uma escala de valores entre 0.0 e 1.0.</dd>
</dl>

<h3 id="Eventos">Eventos</h3>

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

<h2 id="Métodos">Métodos</h2>

<p>Herdado de {{domxref("EventTarget")}}:</p>

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

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

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Status</th>
   <th scope="col">Comentário</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Battery API')}}</td>
   <td>{{Spec2('Battery API')}}</td>
   <td>Especificação Inicial.</td>
  </tr>
 </tbody>
</table>

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

<p>{{ CompatibilityTable() }}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Funcionalidade</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Suporte básico</td>
   <td>{{ CompatNo() }}<br>
    Chrome para Android: <a href="http://crbug.com/135863">crbug.com/135863</a><br>
    Chrome OS: <a href="http://crbug.com/122593">crbug.com/122593</a></td>
   <td>{{CompatGeckoDesktop("10")}} {{ property_prefix("moz") }} [1]<br>
    {{CompatGeckoDesktop("16")}} (sem prefixo) [2]</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Funcionalidade</th>
   <th>Android</th>
   <th>Chrome para Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suporte básico</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{CompatGeckoMobile("10")}} {{ property_prefix("moz") }} [1]<br>
    {{CompatGeckoMobile("16")}} (sem prefixo) [2]</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
  </tr>
 </tbody>
</table>
</div>

<h3 id="Notas_para_o_Gecko">Notas para o Gecko</h3>

<p>[1] Desabilitado por padrão no Firefox 10.0, mas pode ser habilitado alterando a preferência <code>dom.battery.enabled</code> para <code>true</code>. A partir do Firefox 11.0, <code>mozBattery</code> é habilitado por padrão.</p>

<p>[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")}};</p>

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

<ul>
 <li>{{ domxref("Navigator.battery","navigator.battery") }}</li>
 <li>A <a href="/pt-BR/docs/WebAPI/Battery_Status" title="/en-US/docs/WebAPI/Battery_Status">Battery Status API</a></li>
</ul>