BatteryManager - 提供了获取系统电池电量信息的方法
已废弃
该特性已经从 Web 标准中删除，虽然一些浏览器目前仍然支持它，但也许会在未来的某个时间停止支持，请尽量不要使用该特性。
BatteryManager 接口提供了获取系统电池电量信息的方法。
navigator.getBattery() 方法返回一个 Promise，解析为一个 BatteryManager 接口，您可以使用它与电池状态 API 交互。
属性
BatteryManager.charging 只读
一个布尔值，指示电池是否正在被充电。
BatteryManager.chargingTime 只读
一个数字，以秒为单位表示电池充满电前的剩余时间，如果电池已经充满电，则为 0。
BatteryManager.dischargingTime 只读
一个数字，表示电池完全放电至系统将暂停之前的剩余时间（以秒为单位）。
BatteryManager.level 只读
一个数字，表示系统的电池充电水平，为 0.0 至 1.0 之间的数值。
事件处理程序
BatteryManager.onchargingchange
chargingchange 事件的处理程序；更新电池充电状态时会触发此事件。
BatteryManager.onchargingtimechange
chargingtimechange 事件的处理程序；更新电池充电时间时会触发此事件。
BatteryManager.ondischargingtimechange
dischargingtimechange 事件的处理程序；更新电池放电时间时会触发此事件。
BatteryManager.onlevelchange
levelchange 事件的处理程序；更新电池电量时会触发此事件。
方法
从其父接口 eventtarget 继承了方法。
规范
| 规范 | 状态 | 备注 |
|---|---|---|
| Battery Status API | 候选推荐 | 初始定义 |
桌面浏览器兼容性
| 特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基础支持 | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
charging | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
chargingTime | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
dischargingTime | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
level | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
onchargingchange | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
onchargingtimechange | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
ondischargingtimechange | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
onlevelchange | 38 | 79 | 16 — 52 10 — 16 moz 522 723 | 不支持 | 25 | 不支持 |
移动浏览器兼容性
| 特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| 基础支持 | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
charging | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
chargingTime | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
dischargingTime | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
level | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
onchargingchange | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
onchargingtimechange | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
ondischargingtimechange | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
onlevelchange | 40 | 381 | 未知 | 10 — 16 moz 16 — 524 | 未知 | 25 | 支持 —? |
1. BatteryManager.chargingTime 和 BatteryManager.dischargingTime 的值总是等于 Infinity。
2. 在 Firefox 10 中，默认情况下是禁用的，但可以将偏好设置 dom.battery.enabled 改为 true 来启用。从 Firefox 11 开始，mozBattery 默认为启用。目前 Android、Windows 和 Linux 在安装了 UPower 的情况下都支持 Battery API。从 Firefox 18 开始支持 MacOS。Firefox 还提供了对已废弃的 navigator.battery 的支持。
3. 从这个版本开始，BatteryManager 只能在 chrome / 特权代码中使用。
4. 在 Firefox 10 中，默认情况下是禁用的，但可以将偏好设置 dom.battery.enabled 改为 true 来启用。从 Firefox 11 开始，mozBattery 默认为启用。目前 Android、Windows 和 Linux 在安装了 UPower 的情况下都支持 Battery API。从 Firefox 18（Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15）开始支持 MacOS。Firefox 还提供了对已废弃的 navigator.battery 的支持。