Sumario
La interfaz BatteryManager
proporciona la información del nivel de carga de la bateria del sistema.
La propiedad navigator.battery
devuelve una petición de la interfaz BatteryManager
que se utiliza para interactuar con la API Battery Status.
Propiedades
-
BatteryManager.charging
Read only - Valor booleano que indica si la bateria se está o no cargando.
-
BatteryManager.chargingTime
Read only - Número que indica el tiempo que queda en segundos hasta que la batería esté completamente cargada, o 0 si la batería está completamente cargada.
-
BatteryManager.dischargingTime
Read only - Número que indica el tiempo restante en segundos hasta que la batería esté completamente descargada y el sistema entra en suspensión.
-
BatteryManager.level
Read only - Número que indica el nivel de carga de la batería del sistema, los valores están escalados entre 0.0 y 1.0.
Eventos del controlador
-
BatteryManager.onchargingchange
-
Controlador para el evento
chargingchange
; Este evento se envía cuando se actualiza el estado de carga de la batería. -
BatteryManager.onchargingtimechange
-
Controlador para el evento
chargingtimechange
; Este evento se envía cuando se actualiza el tiempo de carga de la batería. -
BatteryManager.ondischargingtimechange
-
Controlador para el evento
dischargingtimechange
; Este evento se envía cuando se actualiza el tiempo de descarga de la batería. -
BatteryManager.onlevelchange
-
Controlador para el evento
levelchange
; Este evento se envía cuando se actualizael nivel de la batería.
Métodos
Heredado deEventTarget
:
EventTarget.addEventListener()
- Registers an event handler of a specific event type on the
EventTarget
. EventTarget.removeEventListener()
- Removes an event listener from the
EventTarget
. EventTarget.dispatchEvent()
- Dispatches an event to this
EventTarget
.
Additional methods for Mozilla chrome code
Mozilla includes a couple of extensions for use by JS-implemented event targets to implement onevent
properties. See also WebIDL bindings.
void setEventHandler(DOMString type, EventHandler handler)
EventHandler getEventHandler(DOMString type)
Especificaciones
Especificaciones | Estado | Comentario |
---|---|---|
Battery Status API | Candidate Recommendation | Especificaciones iniciales. |
Compatibilidad
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | Sin soporte Chrome on Android: crbug.com/135863 Chrome OS: crbug.com/122593 |
10 (10) moz [1] 16 (16) (without prefix) [2] |
Sin soporte | Sin soporte | Sin soporte |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | Sin soporte | 10.0 (10) moz [1] 16.0 (16) (without prefix) [2] |
Sin soporte | Sin soporte | Sin soporte |
Notas Gecko
[1] Descativado por defecto en Firefox 10.0, pero se puede habilitar estableciendo las preferencias en dom.battery.enabled
a true
. A partir de Firefox 11.0, mozBattery
está activado por defecto.
[2] La Battery API actualmente es soportada por Android, Windows, y Linux con UPower instalado. Está soportado para MacOS con Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15).