battery

Reads device battery level and charging state via the Battery Status API.

Import: @rtorcato/browser-common/battery

📖 MDN: Battery Status API

The Battery Status API is Chromium-only and the spec is dormant — getBatteryManager() resolves to undefined where unsupported, so guard with isBatteryApiAvailable() first.

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
Navigator.getBattery	✅ 38+	✅ 79+	❌ removed in 52	❌	❌	Limited

Needs: secure context (HTTPS)

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: Navigator.getBattery

Example

import {
  isBatteryApiAvailable,
  getBatteryManager,
  onBatteryLevelChange,
} from '@rtorcato/browser-common/battery'

if (isBatteryApiAvailable()) {
  const battery = await getBatteryManager()
  const off = battery && onBatteryLevelChange(battery, () => console.log(battery.level))
  off?.()
}

Exports

• isBatteryApiAvailable() — feature check
• getBatteryManager() — resolves to the BatteryManager, or undefined
• onBatteryLevelChange(battery, callback) — subscribes to level changes, returns an unsubscribe function
• onBatteryChargingChange(battery, callback) — subscribes to charging state changes, returns an unsubscribe function

See the API reference for full signatures.