行動裝置佔比一路攀升,為了他們,業界甚至專門設計了一批 API 與設計準則。W3C 的 Battery Status API 就是很典型的例子:它讓網頁能讀取裝置的電池資訊,據此調整行為,例如低電量時關掉動畫、停止輪詢。本文帶你看這個 API 怎麼用、怎麼整合進既有專案。
這個 API 的支援度一直不算完整,所以第一步永遠是特性檢測。早期版本透過 navigator.battery 讀取,Firefox 曾用前綴寫法 navigator.mozBattery;後來標準改為非同步的 navigator.getBattery(),回傳 Promise。撰寫時建議三種都試,取到哪個用哪個。
function getBattery() {
if (navigator.getBattery) return navigator.getBattery(); // 現行標準
if (navigator.battery) return Promise.resolve(navigator.battery); // 舊版
if (navigator.mozBattery) return Promise.resolve(navigator.mozBattery);
return Promise.resolve(null); // 不支援
}
需要注意的是,近年部分瀏覽器基於隱私與防指紋追蹤的考量,已經收緊甚至移除了這項能力。因此務必保留降級路徑:拿不到電池資訊時,應用程式要照常運作。
true。0;未充電或無法估算時為 Infinity。Infinity。1.0 代表已充滿、無電池或數值不可用。每個屬性都綁定一個事件,用來通知狀態變化。例如插入電源會讓 charging 從 false 變成 true,同時觸發 chargingchange。
chargingchange → 對應 onchargingchangechargingtimechange → 對應 onchargingtimechangedischargingtimechange → 對應 ondischargingtimechangelevelchange → 對應 onlevelchange下面的頁面把四個屬性顯示出來,並在事件觸發時重新整理畫面。使用新版 API 時,記得在 Promise 的 then 裡註冊事件。
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8" />
<title>Battery Status API - Example</title>
<script>
function bindBatteryEvents(battery) {
function displayBatteryStats() {
document.getElementById('charging').textContent =
battery.charging ? '充電中' : '未使用電源';
document.getElementById('chargingtime').textContent = battery.chargingTime;
document.getElementById('dischargingtime').textContent = battery.dischargingTime;
document.getElementById('level').textContent = battery.level * 100;
}
displayBatteryStats();
battery.addEventListener('chargingchange', displayBatteryStats, false);
battery.addEventListener('chargingtimechange', displayBatteryStats, false);
battery.addEventListener('dischargingtimechange', displayBatteryStats, false);
battery.addEventListener('levelchange', displayBatteryStats, false);
}
window.addEventListener('load', function () {
if (navigator.getBattery) {
navigator.getBattery().then(function (battery) {
if (battery) bindBatteryEvents(battery);
});
} else if (navigator.battery || navigator.mozBattery) {
bindBatteryEvents(navigator.battery || navigator.mozBattery);
} else {
document.getElementById('stats').textContent =
'很抱歉,你的瀏覽器不支援 Battery Status API';
}
}, false);
</script>
</head>
<body>
<div id="stats">
目前狀態:<span id="charging"></span><br />
充滿還需 <span id="chargingtime"></span> 秒<br />
可用電力還剩 <span id="dischargingtime"></span> 秒<br />
電量 <span id="level"></span>%
</div>
</body>
</html>
最常見的用法是「省電模式」:電量低於某個門檻就停止自動播放、降低動畫幀率、把輪詢間隔拉長;充電時則恢復完整效果。因為這些數值隨時在變,與其定時輪詢,不如直接掛 levelchange 事件來得省事又省電。