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 Status Comment
Battery Status API Candidate Recommendation Initial specification.

Compatibilidad del Navegador

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support Not supported
Chrome on Android: crbug.com/135863
Chrome OS: crbug.com/122593
10 (10) moz [1]
16 (16) (without prefix) [2]
Not supported Not supported Not supported
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? Not supported 10.0 (10) moz [1]
16.0 (16) (without prefix) [2]
Not supported Not supported Not supported

Gecko notes

[1] Disabled by default in Firefox 10.0, but can be enabled setting the preference dom.battery.enabled to true. Starting with Firefox 11.0, mozBattery is enabled by default.

[2] The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15 / Firefox OS 1.0.1).

Vea también

Etiquetas y colaboradores del documento

Colaboradores de esta página: sinfallas
Última actualización por: sinfallas,