diff options
| -rw-r--r-- | files/es/web/api/battery_status_api/index.html | 40 | ||||
| -rw-r--r-- | files/es/web/api/battery_status_api/index.md | 87 |
2 files changed, 87 insertions, 40 deletions
diff --git a/files/es/web/api/battery_status_api/index.html b/files/es/web/api/battery_status_api/index.html deleted file mode 100644 index 2aea788656..0000000000 --- a/files/es/web/api/battery_status_api/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: API de Estado de Bateria -slug: Web/API/Battery_Status_API -tags: - - API - - Apps - - Firefox OS - - Mobile -translation_of: Web/API/Battery_Status_API -original_slug: WebAPI/Estado_de_Bateria ---- -<p>La <strong>API de Estado de Batería</strong>, también conocida como "<strong>Battery API</strong>", 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.</p> -<p>La API de Estado de Batería se puede extender mediante {{domxref("window.navigator")}} con una propiedad {{domxref("window.navigator.battery")}} que pertenece al objeto {{domxref("BatteryManager")}} y agrega algunos nuevos eventos que usted puede recibir en el monitor de estado de la batería.</p> -<h2 id="Ejemplo">Ejemplo</h2> -<p>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 {{event("chargingchange")}} y el evento {{event("levelchange")}} respectivamente.</p> -<pre class="brush: js">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(); -</pre> -<p>Vea también: <a class="external" href="http://dev.w3.org/2009/dap/system-info/battery-status.html#introduction">El ejemplo en las especificaciones</a></p> -<h2 id="Especificaciones">Especificaciones</h2> -<p>{{page("/en-US/docs/Web/API/BatteryManager","Specifications")}}</p> -<h2 id="Compatibilidad_del_Navegador">Compatibilidad del Navegador</h2> -<p>{{page("/en-US/docs/Web/API/BatteryManager","Browser_compatibility")}}</p> -<h2 id="Vea_también">Vea también</h2> -<ul> - <li><a class="external" href="http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/">Hacks blog post - Usando la API de Batería</a></li> - <li>{{domxref("BatteryManager")}}</li> - <li>{{domxref("window.navigator.battery","navigator.battery")}}</li> -</ul> diff --git a/files/es/web/api/battery_status_api/index.md b/files/es/web/api/battery_status_api/index.md new file mode 100644 index 0000000000..3accd0836b --- /dev/null +++ b/files/es/web/api/battery_status_api/index.md @@ -0,0 +1,87 @@ +--- +title: API de Estado de Bateria +slug: Web/API/Battery_Status_API +tags: + - API + - Apps + - Firefox OS + - Mobile +translation_of: Web/API/Battery_Status_API +original_slug: Web/API/Estado_de_Bateria +browser-compat: api.BatteryManager +--- +{{DefaultAPISidebar("Battery API")}}{{deprecated_header}} + +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. + +> **Nota:** Esta API _no está disponible_ en los [Web Workers](/es/docs/Web/API/Web_Workers_API) (no está expuesta en {{domxref("WorkerNavigator")}}). + +## Interfaces + +- {{domxref("BatteryManager")}} + - : Provee información acerca del nivel de carga de batería del sistema. +- {{domxref("navigator.getBattery()")}}{{readonlyInline}} + - : Retorna una {{JSxRef("Promise")}} que se resuelve con un objeto {{DOMxRef("BatteryManager")}}. + +## 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 los eventos {{event("chargingchange")}}, {{event("levelchange")}}, {{event("chargingtimechange")}} y {{event("dischargingtimechange")}}. + +```js +navigator.getBattery().then(function(battery) { + function updateAllBatteryInfo(){ + updateChargeInfo(); + updateLevelInfo(); + updateChargingInfo(); + updateDischargingInfo(); + } + updateAllBatteryInfo(); + + battery.addEventListener('chargingchange', function(){ + updateChargeInfo(); + }); + function updateChargeInfo(){ + console.log("La batería esta cargando? " + + (battery.charging ? "Si" : "No")); + } + + battery.addEventListener('levelchange', function(){ + updateLevelInfo(); + }); + function updateLevelInfo(){ + console.log("Nivel de la batería: " + + battery.level * 100 + "%"); + } + + battery.addEventListener('chargingtimechange', function(){ + updateChargingInfo(); + }); + function updateChargingInfo(){ + console.log("Tiempo de carga de la batería: " + + battery.chargingTime + " segundos"); + } + + battery.addEventListener('dischargingtimechange', function(){ + updateDischargingInfo(); + }); + function updateDischargingInfo(){ + console.log("Tiempo de descarga de la batería: " + + battery.dischargingTime + " segundos"); + } + +}); +``` + +Vea también: [El ejemplo en las especificaciones](https://www.w3.org/TR/battery-status/#examples). + +## Especificaciones + +{{Specifications}} + +## Compatibilidad del Navegador + +{{Compat}} + +## Vea también + +- [Hacks blog post - Usando la API de Batería](https://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/) |