BatteryManager

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

BatteryManager 介面是 Battery Status API 的一部分,它提供有關係統電池充電狀態的資訊。navigator.getBattery() 方法返回一個 Promise,該 Promise 解析為一個 BatteryManager 介面。

從 Chrome 103 開始,Battery Status 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 屬性)更新時觸發。

規範

規範
Battery Status API
# the-batterymanager-interface

瀏覽器相容性

另見