-
Notifications
You must be signed in to change notification settings - Fork 8k
/
index.md
79 lines (51 loc) · 2.78 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
---
title: Navigator.getBattery()
slug: Web/API/Navigator/getBattery
---
{{ ApiRef("Battery API") }}
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
{{domxref("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](/es/docs/Web/API/Battery_Status_API); 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 {{HTTPHeader("Feature-Policy")}}: {{HTTPHeader("Feature-Policy/battery","battery")}}.
## Sintaxis
```js
getBattery();
```
### Parámetros
Ninguno.
### Valor de retorno
Una {{JSxRef("Promise")}} que, cuando finaliza, llama a su manejador de cumplimiento con un
solo parámetro: un objeto {{DOMxRef("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 {{domxref("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 {{HTTPHeader("Feature-Policy")}} {{HTTPHeader("Feature-Policy/battery", "battery")}}.
## Ejemplos
Este ejemplo obtiene el estado actual de carga de la batería y establece un
manejador para el evento [`chargingchange`](/es/docs/Web/Reference/Events/chargingchange), de manera tal que el estado de carga
es grabado cuando cambia.
```js
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](/es/docs/Web/API/Battery_Status_API).
## Especificaciones
{{Specifications}}
## Compatibilidad con navegadores
{{Compat}}
## Véase también
- [API de Estado de Batería](/es/docs/Web/API/Battery_Status_API)
- Característica `Feature-Policy` {{HTTPHeader("Feature-Policy/battery", "battery")}}