BatteryManager | AIUI | Rokid

Use navigator.getBattery() to read host-provided battery status and a BatteryManager to observe charging state, level, and estimated-time changes.

BatteryManager

Use navigator.getBattery() to read host-provided battery status and a BatteryManager to observe charging state, level, and estimated-time changes.

Read Battery Status

const battery = await navigator.getBattery();

console.log('level:', battery.level);
console.log('charging:', battery.charging);

level ranges from 0.0 to 1.0. When the host cannot provide a meaningful estimate, chargingTime or dischargingTime is Infinity.

Observe Battery Changes

const battery = await navigator.getBattery();

battery.addEventListener('levelchange', () => {
  console.log('level:', battery.level);
});

battery.onchargingchange = () => {
  console.log('charging:', battery.charging);
};

An event is dispatched only when its backing value actually changes.

Availability and Current Behavior

  • A BatteryManager is obtained only through navigator.getBattery() and cannot be constructed directly.
  • Battery support is host-provided. navigator.getBattery() rejects when the host has not registered this capability.
  • Events use the standard Event shape and carry no custom battery payload; read the latest value from the battery object.

API Reference

navigator.getBattery()

Returns Promise<BatteryManager>. A created battery manager is reused by the same navigator instance.

BatteryManager Properties

PropertyTypeDescription
chargingbooleanWhether the battery is charging or already full.
chargingTimenumberSeconds until fully charged, or Infinity when unavailable.
dischargingTimenumberSeconds until fully discharged, or Infinity when unavailable.
levelnumberNormalized battery level from 0.0 to 1.0.

BatteryManager Events

EventHandler PropertyTrigger
chargingchangeonchargingchangecharging changes.
chargingtimechangeonchargingtimechangechargingTime changes.
dischargingtimechangeondischargingtimechangedischargingTime changes.
levelchangeonlevelchangelevel changes.