大网数据广告活动
Web 标准与前端开发

Navigator:getBattery() 方法

· 52CE 我爱测

`getBattery()`** 方法提供了系统的电池信息,它返回一个包含电池对象的 promise 对象,兑现一个 BatteryManager 对象,它提供了一些新的属性和事件来获取与监控电池状态。这个方法实现了 Battery Status API,参见那篇文档以获得更多额外的细节、使用 API 的指引和示例代码。

Battery API

getBattery() 方法提供了系统的电池信息,它返回一个包含电池对象的 promise 对象,兑现一个 BatteryManager 对象,它提供了一些新的属性和事件来获取与监控电池状态。这个方法实现了 Battery Status API,参见那篇文档以获得更多额外的细节、使用 API 的指引和示例代码。

自 Chrome 103 起,Battery Status API 的 Navigator.getBattery() 方法只在严格上下文中暴露。

[!NOTE] 对该特性的访问可由 Permissions-Policy 的 Permissions-Policy/battery 指令控制。

语法

getBattery()

参数

无。

返回值

一个 Promise,兑现一个可用于获取电池状态信息的 BatteryManager 对象。

异常

  • NotAllowedError DOMException
  • SecurityError
    • : 用户代理不会向不安全上下文暴露电池信息,而此方法在不安全的上下文中被调用了。

示例

此示例获取了电池当前充电的状态,并建立了 BatteryManager/chargingchange_event 事件的处理器,因此当充电状态发生变化时,其状态会被记录下来。

let batteryIsCharging = false;

navigator.getBattery().then((battery) => {
  batteryIsCharging = battery.charging;

  battery.addEventListener("chargingchange", () => {
    batteryIsCharging = battery.charging;
  });
});

对于更多示例与具体信息,参见 Battery Status API。

规范

浏览器兼容性

参见

  • Battery Status API
  • Permissions-Policy 的 Permissions-Policy/battery 指令

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。