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 compatibility table 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
A handler for the chargingchange event; This event is sent when the battery charging state is updated.
BatteryManager.onchargingtimechange
A handler for the chargingtimechange event; This event is sent when the battery charging time is updated
BatteryManager.ondischargingtimechange
A handler for the dischargingtimechange event; This event is sent when the battery discharging time is updated.
BatteryManager.onlevelchange
A handler for the levelchange event; This event is sent when the battery level is updated.

方法

Inherited from EventTarget :

EventTarget .addEventListener()
Registers an event handler of a specific event type on the EventTarget .
EventTarget .removeEventListener()
Removes an event listener from the EventTarget .
EventTarget .dispatchEvent()
Dispatches an event to this EventTarget .

Additional methods in Mozilla chrome codebase

Mozilla includes a couple of extensions for use by JS-implemented event targets to implement on event 特性。

另请参阅 WebIDL bindings .

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

规范

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

浏览器兼容性

更新 GitHub 上的兼容性数据
Desktop Mobile
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 .

图例

完整支持
完整支持
不支持
不支持
弃用。不要用于新网站。
弃用。不要用于新网站。
见实现注意事项。
用户必须明确启用此特征。
用户必须明确启用此特征。
要求使用供应商前缀或不同名称。
要求使用供应商前缀或不同名称。

另请参阅