HTML5 Battery API可获取设备电池信息,通过navigator.getBattery()返回BatteryManager对象,支持监听chargingchange和levelchange事件以检测充电状态及电量变化,主要属性包括level、charging、chargingTime和dischargingTime,但因隐私问题,现代浏览器已逐步限制该API使用。

HTML5 电池状态 API(Battery Status API)可以用来获取设备的电池信息,比如电量水平、充电状态等。虽然这个 API 目前在部分浏览器中已被弃用或限制使用,但在一些支持它的环境中仍可使用。下面介绍如何使用它来检测设备电池状态。
1. 获取电池对象
通过 navigator.getBattery() 方法可以获取一个 Promise,该 Promise 返回一个 BatteryManager 对象,包含当前设备的电池状态信息。
示例代码:if ('getBattery' in navigator) {
navigator.getBattery().then(function(battery) {
console.log('当前电量:', battery.level * 100 + '%');
console.log('是否正在充电:', battery.charging ? '是' : '否');
});
} else {
console.log('当前浏览器不支持电池状态 API');
}2. 监听电池状态变化
BatteryManager 接口提供了多个事件,可用于监听电池属性的变化,例如电量改变、充电状态切换等。
- chargingchange:当设备开始或停止充电时触发
- levelchange:当电量百分比发生变化时触发
navigator.getBattery().then(function(battery) {
battery.addEventListener('chargingchange', function() {
console.log('充电状态变为:', battery.charging ? '充电中' : '未充电');
});
battery.addEventListener('levelchange', function() {
console.log('电量更新为:', (battery.level * 100).toFixed(2) + '%');
});
});
3. 常用属性说明
BatteryManager 对象提供以下关键属性:
立即学习“前端免费学习笔记(深入)”;
- battery.level:当前电量比例,范围 0 到 1,1 表示满电
- battery.charging:布尔值,表示是否正在充电
- battery.chargingTime:距离充满电还需多少秒,若已充满则为 0
- battery.dischargingTime:预计剩余放电时间(秒),即还能用多久
注意:
由于隐私和安全原因,现代浏览器如 Chrome 已逐步限制或弃用此 API。某些属性可能始终返回固定值(如 chargingTime 恒为 0),或仅在 HTTPS 环境下可用。
基本上就这些。虽然功能直观,但实际应用中需考虑兼容性和浏览器策略限制。











