弃用
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the
兼容性表格
at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Battery Status API , more often referred to as the 电池 API , provides information about the system's battery charge level and lets you be notified by events that are sent when the battery level or charging status change. This can be used to adjust your app's resource usage to reduce battery drain when the battery is low, or to save changes before the battery runs out in order to prevent data loss.
The Battery Status API extends
window.navigator
采用
navigator.getBattery()
method returning a battery promise, which is resolved in a
BatteryManager
object providing also some new events you can handle to monitor the battery status.
In this example, we watch for changes both to the charging status (whether or not we're plugged in and charging) and for changes to the battery level and timing. This is done by listening for the
chargingchange
,
levelchange
,
chargingtimechange
,
dischargingtimechange
事件。
navigator.getBattery().then(function(battery) {
function updateAllBatteryInfo(){
updateChargeInfo();
updateLevelInfo();
updateChargingInfo();
updateDischargingInfo();
}
updateAllBatteryInfo();
battery.addEventListener('chargingchange', function(){
updateChargeInfo();
});
function updateChargeInfo(){
console.log("Battery charging? "
+ (battery.charging ? "Yes" : "No"));
}
battery.addEventListener('levelchange', function(){
updateLevelInfo();
});
function updateLevelInfo(){
console.log("Battery level: "
+ battery.level * 100 + "%");
}
battery.addEventListener('chargingtimechange', function(){
updateChargingInfo();
});
function updateChargingInfo(){
console.log("Battery charging time: "
+ battery.chargingTime + " seconds");
}
battery.addEventListener('dischargingtimechange', function(){
updateDischargingInfo();
});
function updateDischargingInfo(){
console.log("Battery discharging time: "
+ battery.dischargingTime + " seconds");
}
});
另请参阅 the example in the specification .
| 规范 | 状态 | 注释 |
|---|---|---|
| Battery Status API | 候选推荐 | 初始定义。 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
BatteryManager
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
charging
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
chargingTime
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
dischargingTime
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
level
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
onchargingchange
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
onchargingtimechange
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
ondischargingtimechange
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
onlevelchange
弃用
|
Chrome 38 | Edge 79 |
Firefox
16 — 52
|
IE No | Opera 25 | Safari No | WebView Android 40 |
Chrome Android
38
|
Firefox Android
10 — 16
Prefixed
|
Opera Android 25 | Safari iOS ? — ? |
Samsung Internet Android
3.0
|
完整支持
不支持
弃用。不要用于新网站。
见实现注意事项。
用户必须明确启用此特征。
要求使用供应商前缀或不同名称。