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
|
---
title: window.navigator.battery
slug: DOM/window.navigator.battery
translation_of: Web/API/Navigator/battery
---
<p>{{ ApiRef() }}</p>
<p><strong>Battery Status API</strong>, useimmiten lyhennettynä <em>Battery API</em>, tarjoaa tietoa järjestelmän akun lataustasosta ja sallii sinulle ilmoitettavan muutaman akkutasomuutostapahtuman kautta. Tätä voitaisiin käyttää lataamaan vähemmän suoritinintensiiviset tehtävät sivustollasi, jos akkuvirta on vähissä ja tallentaa muutokset ennen akkuvirran loppumista, jotta estetään tietojen häviäminen.</p>
<p>Battery Status API laajentaa {{domxref("window.navigator")}}-objektin metodilla <code>battery</code>. Se määrittää myös muutamia uusia tapahtumia.</p>
<h2 id="Attribuutit">Attribuutit</h2>
<dl>
<dt>
<code>charging</code></dt>
<dd>
<strong>Kirjoitussuojattu</strong>. Boolean-arvo edustaa järjestelmän akun lataustilaa. Palauttaa arvon <code>true</code>, jos akkua ladataan, jos järjestelmän akun tila ei ole määriteltävissä, tai jos akkua ei ole liitetty järjestelmään. Palauttaa arvon <code>false</code>, jos akkua puretaan.</dd>
<dt>
<code>chargingTime</code></dt>
<dd>
<strong>Kirjoitussuojattu</strong>. Double-arvo edustaa jäljellä olevaa sekuntimäärää siihen kun järjestelmän akku ladattu täyteen. Palauttaa arvon 0, jos akku on ladattu täyteen.<br>
Palauttaa positiivisen äärettämän arvon, jos akkua puretaan tai jos toteutus ei kykene ilmoittamaan jäljellä olevaa latausaikaa.</dd>
<dt>
<code>dischargingTime</code></dt>
<dd>
<strong>Kirjoitussuojattu</strong>. Double-arvo edustaa jäljellä olevaa sekuntimäärää siihen kun järjestelmän akku on täysin purettu ja järjestelmä keskeytetään. Palauttaa positiivisen äärettömän arvon, jos akkua ladataan, jos toteutus ei kykene ilmoittamaan purkamisaikaa, tai jos järjestelmään ei ole liitetty akkua.</dd>
<dt>
<code>level</code></dt>
<dd>
<strong>Kirjoitussuojattu</strong>. Double-arvo edustaa järjestelmän akun lataustasoa skaalalla 0 ... 1.0. Palauttaa arvon 0, jos akku on tyhjä ja järjestelmä on siirtymässä keskeytystilaan. Palauttaa arvon 1.0, jos akku on täynnä, jos toteutus ei kykene ilmoittamaan akun tasoa, tai jos akkua ei ole liitetty järjestelmään.</dd>
</dl>
<h2 id="Tapahtumat">Tapahtumat</h2>
<dl>
<dt>
<code>chargingchange</code></dt>
<dd>
Laukeaa, kun akun lataustilaa päivitetään.</dd>
<dt>
<code>chargingtimechange</code></dt>
<dd>
Laukeaa, kun akun latausaikaa päivitetään.</dd>
<dt>
<code>dischargingtimechange</code></dt>
<dd>
Laukeaa, kun akun purkausaikaa päivitetään.</dd>
<dt>
<code>levelchange</code></dt>
<dd>
Laukeaa, kun akun tasoa päivitetään.</dd>
</dl>
<h2 id="Esimerkki">Esimerkki</h2>
<p>Katso myös <a class="external" href="http://dev.w3.org/2009/dap/system-info/battery-status.html#introduction">esimerkkiä spesifikaatiossa</a>.</p>
<pre class="brush: js">var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery;
function updateBatteryStatus() {
alert("Battery status: " + battery.level * 100 + " %");
if (battery.charging) {
alert("Battery is charging");
}
}
battery.addEventListener("chargingchange", updateBatteryStatus);
battery.addEventListener("levelchange", updateBatteryStatus);
updateBatteryStatus();
</pre>
<h2 id="Spesifikaatiot">Spesifikaatiot</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Spesifikaatio</th>
<th scope="col">Tila</th>
<th scope="col">Kommentti</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('Battery API')}}</td>
<td>{{Spec2('Battery API')}}</td>
<td>Alustava spesifikaatio.</td>
</tr>
</tbody>
</table>
<h2 id="Selainyhteensopivuus">Selainyhteensopivuus</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>Perustuki</td>
<td>20 {{ property_prefix("webkit") }}</td>
<td>{{CompatGeckoDesktop("10")}} {{ property_prefix("moz") }} [1]<br>
{{CompatGeckoDesktop("16")}} (without prefix) [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>Feature</th>
<th>Android</th>
<th>Firefox Mobile (Gecko)</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
</tr>
<tr>
<td>Perustuki</td>
<td>20 {{ property_prefix("webkit") }}</td>
<td>{{CompatGeckoMobile("10")}} {{ property_prefix("moz") }} [1]<br>
{{CompatGeckoMobile("16")}} (without prefix) [2]</td>
<td>{{ CompatNo() }}</td>
<td>{{ CompatNo() }}</td>
<td>{{ CompatNo() }}</td>
</tr>
</tbody>
</table>
</div>
<h3 id="Gecko-kommentit">Gecko-kommentit</h3>
<p>[1] Disabled by default in Firefox 10.0, but can be enabled setting the preference <code>dom.battery.enabled</code> to <code>true</code>. Starting with Firefox 11.0, <code>mozBattery</code> is enabled by default.</p>
<p class="note">[2] The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 {{geckoRelease("18.0")}}.</p>
<h2 id="Katso_myös">Katso myös</h2>
<ul>
<li><a class="external" href="http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/">Blog post - Using the Battery API</a></li>
<li><a class="external" href="http://davidwalsh.name/battery-api" title="http://davidwalsh.name/battery-api">David Walsh on the JavaScript Battery Api</a></li>
<li><a href="https://github.com/pstadler/battery.js" title="https://github.com/pstadler/battery.js">battery.js - a tiny cross-browser wrapper</a></li>
</ul>
|
