Battery Status API

弃用
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.

Battery Status API , more often referred to as the 电池 API , provides information about the system's battery charge level and lets you be notified by events that are sent when the battery level or charging status change. This can be used to adjust your app's resource usage to reduce battery drain when the battery is low, or to save changes before the battery runs out in order to prevent data loss.

The Battery Status API extends window.navigator 采用 navigator.getBattery() method returning a battery promise, which is resolved in a BatteryManager object providing also some new events you can handle to monitor the battery status.

范例

In this example, we watch for changes both to the charging status (whether or not we're plugged in and charging) and for changes to the battery level and timing. This is done by listening for the chargingchange , levelchange , chargingtimechange , dischargingtimechange 事件。

navigator.getBattery().then(function(battery) {
  function updateAllBatteryInfo(){
    updateChargeInfo();
    updateLevelInfo();
    updateChargingInfo();
    updateDischargingInfo();
  }
  updateAllBatteryInfo();
  battery.addEventListener('chargingchange', function(){
    updateChargeInfo();
  });
  function updateChargeInfo(){
    console.log("Battery charging? "
                + (battery.charging ? "Yes" : "No"));
  }
  battery.addEventListener('levelchange', function(){
    updateLevelInfo();
  });
  function updateLevelInfo(){
    console.log("Battery level: "
                + battery.level * 100 + "%");
  }
  battery.addEventListener('chargingtimechange', function(){
    updateChargingInfo();
  });
  function updateChargingInfo(){
    console.log("Battery charging time: "
                 + battery.chargingTime + " seconds");
  }
  battery.addEventListener('dischargingtimechange', function(){
    updateDischargingInfo();
  });
  function updateDischargingInfo(){
    console.log("Battery discharging time: "
                 + battery.dischargingTime + " seconds");
  }
});
					

另请参阅 the example in the specification .

规范

规范 状态 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 .

图例

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

另请参阅