就业培训     下载中心     Wiki     联络
登录   注册
  1. 首页
  2. Web API
  3. BatteryManager

在此页

弃用
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the 兼容性表格 at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

BatteryManager interface provides ways to get information about the system's battery charge level.

navigator.getBattery() method returns a battery promise that is resolved in a BatteryManager interface which you can use to interact with the Battery Status API .

特性

BatteryManager.charging 只读

A Boolean value indicating whether or not the battery is currently being charged.

BatteryManager.chargingTime 只读

A number representing the remaining time in seconds until the battery is fully charged, or 0 if the battery is already fully charged.

BatteryManager.dischargingTime 只读

A number representing the remaining time in seconds until the battery is completely discharged and the system will suspend.

BatteryManager.level 只读

A number representing the system's battery charge level scaled to a value between 0.0 and 1.0.

事件处理程序

BatteryManager.onchargingchange
处理程序为 chargingchange event; This event is sent when the battery charging state is updated.
BatteryManager.onchargingtimechange
处理程序为 chargingtimechange event; This event is sent when the battery charging time is updated
BatteryManager.ondischargingtimechange
处理程序为 dischargingtimechange event; This event is sent when the battery discharging time is updated.
BatteryManager.onlevelchange
处理程序为 levelchange event; This event is sent when the battery level is updated.

方法

继承自 EventTarget :

EventTarget .addEventListener()
注册特定事件类型的事件处理程序在 EventTarget .
EventTarget .removeEventListener()
移除事件监听器从 EventTarget .
EventTarget .dispatchEvent()
把事件分派给此 EventTarget .

额外 Mozilla Chrome 代码库方法

Mozilla 包括 2 个扩展，供由 JS 实现的事件目标用于实现 on event 特性。

另请参阅 WebIDL 绑定 .

  • void setEventHandler (DOMString type , EventHandler handler )
  • EventHandler getEventHandler (DOMString type )

规范

规范 状态 注释
Battery Status API 候选推荐 初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
BatteryManager 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
charging 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
chargingTime 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
dischargingTime 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
level 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
onchargingchange 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
onchargingtimechange 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
ondischargingtimechange 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
onlevelchange 弃用 Chrome 38 Edge 79 Firefox 16 — 52
不支持 16 — 52
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
52 Disabled
Disabled by default in Firefox 10, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated navigator.battery .
Disabled From version 52: this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
72
From this version onwards, BatteryManager is only available in chrome/privileged code.
IE No Opera 25 Safari No WebView Android 40 Chrome Android 38
38
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .
Firefox Android 10 — 16 Prefixed
不支持 10 — 16 Prefixed
Prefixed Implemented with the vendor prefix: moz
不支持 16 — 52 Disabled
Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true . Starting with Firefox 11.0, mozBattery is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated navigator.battery .
Disabled From version 16 until version 52 (exclusive): this feature is behind the dom.battery.enabled preference. To change preferences in Firefox, visit about:config.
Opera Android 25 Safari iOS ? — ? Samsung Internet Android 3.0
3.0
Values for BatteryManager.chargingTime and BatteryManager.dischargingTime are always equal to Infinity .

图例

完整支持

完整支持

不支持

不支持

弃用。不要用于新网站。

弃用。不要用于新网站。

见实现注意事项。

用户必须明确启用此特征。

用户必须明确启用此特征。

要求使用供应商前缀或不同名称。

要求使用供应商前缀或不同名称。

另请参阅

元数据

  • 最后修改：
  1. BatteryManager
  2. 特性
    1. charging
    2. chargingTime
    3. dischargingTime
    4. level
    5. onchargingchange
    6. onchargingtimechange
    7. ondischargingtimechange
    8. onlevelchange
  3. 继承：
    1. EventTarget

版权所有  © 2014-2026 乐数软件    

工业和信息化部： 粤ICP备14079481号-1