Navigator.getBattery()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
El método getBattery()
provee información acerca de la
batería del sistema. Retorna una promesa de batería, que es resuelta en un objeto
BatteryManager
proveyendo también algunos eventos nuevos que se pueden manejar
para monitorear el estado de la batería. Esto implementa la API de Estado de Batería; ver esa
documentación para detalles adicionales, una guía para usar la API, y código de ejemplo.
Nota:
En algunos navegadores el acceso a esta característica está controlado por la directiva Feature-Policy
: battery
.
Sintaxis
getBattery();
Parámetros
Ninguno.
Valor de retorno
Una Promise
que, cuando finaliza, llama a su manejador de cumplimiento con un
solo parámetro: un objeto BatteryManager
que puede ser usado para obtener
información acerca del estado de la batería.
Excepciones
Este método no arroja excepciones reales; en su lugar, rechaza la promesa retornada, pasando dentro de ella una DOMException
cuyo name
(nombre) es uno de los siguientes:
SecurityError
-
El Agente de Usuario no expone información de batería a contextos inseguros y este método fue llamado de un contexto inseguro.
Nota: Versiones antiguas de algunos Agentes de Usuario pueden permitir el uso de esta característica en contextos inseguros.
NotAllowedError
-
Ningún Agente de Usuario arroja actualmente esta excepción, pero la especificación describe el siguiente comportamiento:
Este documento no tiene permitido el uso de esta característica. Por ejemplo, puede no estar permitido o restringido explícitamente por medio de la característica
Feature-Policy
battery
.
Ejemplos
Este ejemplo obtiene el estado actual de carga de la batería y establece un
manejador para el evento chargingchange
, de manera tal que el estado de carga
es grabado cuando cambia.
let batteryIsCharging = false;
navigator.getBattery().then(function (battery) {
batteryIsCharging = battery.charging;
battery.addEventListener("chargingchange", function () {
batteryIsCharging = battery.charging;
});
});
Para más ejemplos y detalles, ver API de Estado de Batería.
Especificaciones
Specification |
---|
Battery Status API # dom-navigator-getbattery |
Compatibilidad con navegadores
BCD tables only load in the browser
Véase también
- API de Estado de Batería
- Característica
Feature-Policy
battery