BatteryManager 接口提供方法获取系统电量。
navigator.getBattery 方法返回一个promise对象,该promise将提供一个BatteryManager接口,你可以从Battery Status API 查询到相关信息。
Object.prototype
Function.prototype
EventTarget
BatteryManager
该构造函数没有对应用程序公开,应用程序只需通过Navigator.battery或Navigator.getBattery()来获得设备的电源管理对象。
属性 | 说明 |
---|---|
- | - |
语法 | 说明 |
---|---|
- | - |
Object.prototype
EventTarget.prototype
BatteryManager.prototype
从其父级继承的属性请查阅: EventTarget。
Battery Status API 公开了 window.navigator.battery 对象上的四个只读属性。
属性 | 说明 |
---|---|
charging | 一个布尔值, 它指定电池是否正在充电。如果设备没有电池或无法确定值, 则此属性的值设置为 true。 |
chargingTime | 一个数字, 指定在电池完全充电之前保留的秒数。如果电池已完全充电, 或者设备没有电池, 则将此属性设置为0。如果设备未充电, 或无法确定剩余时间, 则该值为Infinity。 |
dischargingTime | 一个数字值, 表示在电池完全放电之前保留的秒数。如果无法确定放电时间或电池当前充电, 则该值设置为Infinity。如果设备没有电池, 则 dischargingTime 也会设置为Infinity。 |
level | 指定电池当前级别的数字。该值作为浮点, 从0 (discharged) 到 1个 (full charged) 的范围返回。如果无法确定电池的级别, 则电池电量完全充电, 或者设备没有电池, 则level的值等于1。 |
Battery Status API 允许我们监听四个事件, 其中每一项都可以映射到 window.navigator.battery 上的属性的更改。
事件 | 说明 |
---|---|
chargingchange | 当设备的充电器激活或停用时触发该事件。 |
chargingtimechange | 当剩余的充电时间变化时触发。 |
dischargingtimechange | 当剩余时间直到电池完全放电变化时触发。 |
levelchange | 当电池级别已更改时触发。 |
从其父级继承的方法请查阅: EventTarget.
语法 | 说明 | |
---|---|---|
addEventListener() | 在EventTarget上注册特定事件类型的事件处理程序。 | |
removeEventListener() | EventTarget中删除事件侦听器。 | |
dispatchEvent() | 将事件分派到此EventTarget。 |
Object.prototype
EventTarget.prototype
BatteryManager.prototype
BatteryManager 实例