BatteryManager

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器安全上下文(HTTPS)中可用。

电池状态 APIBatteryManager 接口提供了系统电池电量的一些信息。navigator.getBattery() 方法返回一个 promise 对象,其兑现一个 BatteryManager 接口。

自 Chrome 103 起,电池状态 APIBatteryManager 接口只在安全上下文中暴露。

EventTarget BatteryManager

实例属性

也从其父接口 EventTarget 继承属性。

BatteryManager.charging 只读

一个指示当前电池是否正在充电的布尔值。

BatteryManager.chargingTime 只读

一个表示电池距离充电完毕还需多少秒的数字,或为 0 则表示电池已充电完毕。

BatteryManager.dischargingTime 只读

一个表示距离电池完全耗电且系统挂起需要多少秒的数字。

BatteryManager.level 只读

一个表示系统的电池电量水平的数字,其值介于 0.0 和 1.0 之间。

实例方法

也从其父接口 EventTarget 继承方法。

事件

也从其父接口 EventTarget 继承事件。

chargingchange

当电池充电状态(charging 属性)更新时触发。

chargingtimechange

当电池充电时间(chargingTime 属性)更新时触发。

dischargingtimechange

当电池续航时间(dischargingTime 属性)更新时触发。

levelchange

当电池电量(level 属性)更新时触发。

规范

Specification
Battery Status API
# the-batterymanager-interface

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
BatteryManager
charging
chargingTime
chargingchange event
chargingtimechange event
dischargingTime
dischargingtimechange event
level
levelchange event
Secure context required
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Has more compatibility info.

参见