blob: 29b6b46c0dc0e14501c285d2d418fdbb090cdc82 (
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
|
---
title: Navigator.getBattery()
slug: Web/API/Navigator/getBattery
translation_of: Web/API/Navigator/getBattery
---
<p>{{ ApiRef("Battery API") }}</p>
<p><code>getBattery()方法提供了系统的电量信息，返回一个battery的promise对象，然后resolve后得到</code>{{domxref("BatteryManager")}}对象，它提供了一些新的事件，以及方法供您监控电池的状态。这个方法实现了<a href="/en-US/docs/WebAPI/Battery_Status" title="/en-US/docs/WebAPI/Battery_Status">Battery Status API</a> （查看更多细节以及使用方法和实例代码）</p>
<h2 id="Syntax" name="Syntax">语法</h2>
<pre class="syntaxbox">navigator.getBattery().then(funcRef);</pre>
<p><code><em>funcRef</em></code> 是{{domxref("navigator.getBattery")}} 返回的battery promise对象被resolve后执行的函数，即回调函数。</p>
<h2 id="相关规范">相关规范</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">规范</th>
<th scope="col">状态</th>
<th scope="col">阶段</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName("Battery API", "#widl-Navigator-getBattery-Promise-BatteryManager", "Navigator.getBattery")}}</td>
<td>{{Spec2('Battery API')}}</td>
<td>初试定义</td>
</tr>
</tbody>
</table>
<h2 id="浏览器兼容">浏览器兼容</h2>
<p>{{CompatibilityTable}}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>浏览器</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>功能支持</td>
<td>{{CompatChrome(39.0)}}</td>
<td>{{CompatGeckoDesktop("10")}} {{property_prefix("moz")}}<br>
{{CompatGeckoDesktop("16")}}<sup>[1]</sup><br>
{{CompatGeckoDesktop("43")}}<sup>[2]</sup></td>
<td>{{CompatNo}}</td>
<td>25</td>
<td>{{CompatNo}}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>浏览器</th>
<th>Android</th>
<th>Android Webview</th>
<th>Firefox Mobile (Gecko)</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
<th>Chrome for Android</th>
</tr>
<tr>
<td>功能支持</td>
<td>{{CompatNo}}</td>
<td>{{CompatChrome(40.0)}}</td>
<td>
<p>{{CompatGeckoMobile("10")}} {{property_prefix("moz")}}<br>
{{CompatGeckoMobile("16")}}<sup>[1]</sup><br>
{{CompatGeckoDesktop("43")}}<sup>[2]</sup></p>
</td>
<td>{{CompatNo}}</td>
<td>25</td>
<td>{{CompatNo}}</td>
<td>{{CompatChrome(42.0)}}</td>
</tr>
</tbody>
</table>
</div>
<p>[1] 在 Firefox 10.0 被默认禁止, 但可以设置<code>dom.battery.enabled<font face="Open Sans, Arial, sans-serif"> = </font></code><code>true来启用</code>. 从Starting with Firefox 11.0开始, <code>mozBattery</code> 是默认启动的. UPower 安装后， Android, Windows, and Linux.就支持Battery API了。MacOS的支持是从Gecko 18.0 {{geckoRelease("18.0")}}开始的. fireFox依然支持已经被弃用 {{domxref("navigator.battery")}}.</p>
<p>[2] 全新的基于promise语法的{{domxref("Navigator.getBattery()")}}在FireFox 43 被支持。</p>
<h2 id="请参见">请参见</h2>
<ul>
<li><a href="/en-US/docs/WebAPI/Battery_Status" title="/en-US/docs/WebAPI/Battery_Status">Battery Status API</a></li>
</ul>
|
