Battery Status API: privacidad y disponibilidad
Qué expone Battery Status API, por qué su compatibilidad es limitada y cómo usar el estado de la batería sin crear un perfil del usuario.
BotBrowser Team
Quieres la documentación estructurada de Huella digital?
Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.
Si una página cambia la calidad o la frecuencia de actualización según la batería, ¿sigue funcionando cuando el dato falta o cambia durante la interacción? Battery Status API puede informar del estado de carga actual del navegador, del nivel de batería y del tiempo estimado de carga o descarga. Es una señal opcional y de disponibilidad limitada, no una identidad del dispositivo ni una promesa sobre la duración de una sesión. La aplicación debe detectar la función, conservar un comportamiento predeterminado útil y usar el resultado solo para una decisión reversible y visible.
BotBrowser puede probar en un perfil seleccionado la ruta expuesta y la ruta alternativa; no hace que la API esté disponible ni garantiza el tiempo de ejecución.
TL;DR
- Detecta la API y trata la ausencia o el rechazo como la alternativa normal.
- Usa la batería solo para trabajo local y opcional; nunca para identidad, autorización, pagos o solicitudes necesarias.
- Mantén los valores sin procesar fuera de URL, analítica, cuentas y registros duraderos.
- Prueba cambios de estado, cancelación, accesibilidad y la ruta base, no un porcentaje concreto.
Contenido
-
Detecta
navigator.getBattery()y conserva la experiencia base cuando falta o falla. -
Usa el resultado solo para decisiones pequeñas y reversibles, como aplazar una vista previa.
-
Mantén los campos brutos fuera de identificadores, URL, analítica y registros duraderos.
-
BotBrowser permite probar las rutas expuesta y de alternativa en un perfil elegido, pero no hace disponible la API ni garantiza el tiempo de ejecución.
- Qué proporciona Battery Status API
- La falta de compatibilidad es una rama normal
- Toma una decisión pequeña y reversible
- Límites de privacidad y minimización
- Prueba la alternativa, no un valor de batería concreto
- Límite de compatibilidad de BotBrowser
- Conclusión práctica
Qué proporciona Battery Status API
Cuando el navegador expone navigator.getBattery(), la aplicación puede llamarlo. El BatteryManager devuelto puede exponer charging, level, chargingTime y dischargingTime, además de eventos de cambio. Estos valores describen la observación actual del navegador; no son un inventario del hardware, una garantía exacta de autonomía ni una medición de la salud de la batería.
Los valores pueden cambiar durante la visita y el navegador puede ocultarlos, redondearlos o limitarlos según su política. Trátalos como indicios para la tarea actual. Una página puede posponer una animación opcional o reducir las actualizaciones en segundo plano cuando el dispositivo no está cargando, pero no debe quitar contenido necesario ni inferir quién usa la página.
La falta de compatibilidad es una rama normal
MDN clasifica Battery Status API como de disponibilidad limitada. Una página de producción no puede suponer que exista navigator.getBattery ni que su promesa se resuelva. La compatibilidad puede variar según el navegador, la versión, el contexto y la política del agente de usuario. Detecta el método, gestiona el rechazo y conserva la misma experiencia base cuando no haya datos.
No uses el nombre del navegador como sustituto de la detección de capacidades. Prueba el comportamiento que necesita el producto: la página debe seguir siendo utilizable si falta la API, cambia un valor o falla una solicitud. La guía de capacidades del navegador aplica este mismo enfoque de alternativa primero a otra API opcional.
Toma una decisión pequeña y reversible
Empieza por una experiencia base que funcione sin datos de batería. Si hay un resultado, úsalo para elegir entre pocas políticas, por ejemplo normal o con menos trabajo en segundo plano. Conserva navegación, formularios, alternativas multimedia y controles de accesibilidad. Explica cualquier cambio relevante con lenguaje de producto y deja que la persona elija cuando cambien la transferencia de datos, la calidad o la espera.
El estado de la batería no debe controlar autorización, facturación, recuperación de cuentas ni solicitudes necesarias. El servidor no debe depender de un valor de JavaScript que puede faltar o cambiar entre solicitudes. Si la persona selecciona explícitamente un modo de ahorro de datos o de efectos reducidos, envía esa elección en lugar de los campos brutos de batería. Sobre un tema relacionado, la verificación de clientes sin exponer detalles del dispositivo, consulta Private Verification Tokens: propuesta de Chrome y BotBrowser.
Límites de privacidad y minimización
Las lecturas de batería pueden contribuir a la identificación por huella cuando se combinan con otras señales. Mantenlas dentro de la decisión que las necesita y descarta los valores brutos después de seleccionar la política. No añadas por defecto level, el estado de carga ni los tiempos a identificadores de cuenta, URL, etiquetas analíticas o registros de soporte duraderos. Para otra señal del navegador ligada a las preferencias de la persona, consulta Keyboard Layout API, preferencias regionales y privacidad.
Los registros operativos normalmente solo necesitan la política elegida y el resultado, por ejemplo power_policy=reduced y si terminó una tarea opcional. Si un caso de soporte necesita más detalle, explica el propósito, limita el acceso, fija una retención breve y elimina los campos al cerrar el caso. La guía básica de privacidad del navegador trata otras decisiones de minimización.
Prueba la alternativa, no un valor de batería concreto
Las pruebas deben cubrir una API indefinida, el rechazo de getBattery(), cambios en level o charging y un navegador que solo ofrezca la ruta base. Comprueba que el contenido y los controles necesarios sigan disponibles, que el trabajo opcional pueda cancelarse y que la persona pueda recuperarse tras un cambio. No afirmes que un dispositivo concreto debe devolver un porcentaje o tiempo específico.
Respeta la intención y la accesibilidad en todas las ramas. Un modo reducido puede aplazar una vista previa o bajar la frecuencia en segundo plano, pero debe conservar el sentido de la tarea y ofrecer una forma clara de continuar. Evita bucles de reintento y no pidas a la persona que debilite una configuración de privacidad para activar una mejora.
Límite de compatibilidad de BotBrowser
BotBrowser permite probar, con un perfil de navegador seleccionado, cómo gestiona una aplicación Battery Status API cuando el navegador la expone y cómo sigue la alternativa cuando la API no está disponible. Este flujo basado en perfiles no hace que la API esté disponible ni establece la política de programación de la aplicación; la disponibilidad sigue dependiendo del navegador y de la política del perfil. Una lectura no garantiza el tiempo de ejecución ni autoriza una cuenta.
Conclusión práctica
Trata Battery Status API como una entrada opcional y breve. Detecta la función donde se usa, conserva el camino normal cuando no está disponible y explica cualquier cambio relevante a la persona. Valida la ruta con API y la alternativa sin API, y registra la política elegida, no los valores brutos.
Fuentes
Este artículo forma parte de la guía: ¿Qué es la huella digital del navegador?
Artículos Relacionados
Device Memory API y rendimiento web: pistas de memoria seguras
Huella digitalPermisos de Web Bluetooth, selección de dispositivos y privacidad
Huella digitalInformación del adaptador WebGPU y privacidad del usuario
PlataformaNetwork Information API para contenido adaptable: guía con respaldo
Huella digitalRenderizador WebGL ausente: privacidad o contexto
Huella digitalKeyboard Layout API, preferencias regionales y privacidad
Ejecuta la misma comprobación en BotBrowser
Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.