API de Estado de Bateria

La API de Estado de Batería, también conocida como "Battery API", provee información acerca del sistema de carga de la batería y permite notificar mediante eventos que son enviados cuando el nivel de la batería cambia. Este puede ser usado para ajustar el uso de recursos por parte de una aplicación y evitar un gasto innecesario de energía cuando la batería esta baja o para guardar cambios en un archivo antes de que la batería se agote y así prevenir perdida de información.

La API de Estado de Batería se puede extender mediante window.navigator con una propiedad window.navigator.battery que pertenece al objeto BatteryManager y agrega algunos nuevos eventos que usted puede recibir en el monitor de estado de la batería.

Ejemplo

En este ejemplo, observamos los cambios en el estado de la carga (este o no conectado y cargando) y  en el nivel de la batería. Esto se hace escuchando el evento chargingchange y el evento levelchange respectivamente.

var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery;

function updateBatteryStatus() {
  console.log("Battery status: " + battery.level * 100 + " %");

  if (battery.charging) {
    console.log("Battery is charging");
  }
}

battery.addEventListener("chargingchange", updateBatteryStatus);
battery.addEventListener("levelchange", updateBatteryStatus);
updateBatteryStatus();

Vea también: El ejemplo en las especificaciones

Especificaciones

Specification
Battery Status API
# the-batterymanager-interface

Compatibilidad del Navegador

BCD tables only load in the browser

Vea también