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).