blob: 59595e4a78285073b18f98e74d6bddbd8bbeb13f (
plain)
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
|
---
title: window.navigator.battery
slug: Web/API/Navigator/battery
translation_of: Web/API/Navigator/battery
---
<p>{{ Apiref() }}</p>
<p>{{ SeeCompatTable() }}</p>
<p>L'API Battery Status fournit des informations sur le niveau de charge du système et vous permet d'être notifiée via certains évènements si le niveau de batterie varie. Elle peut être utilisée pour privilégier les tâches moins gourmantes en traitement processeur sur votre site si le niveau de batterie est faible ou permettre une sauvegarde de vos travaux pour prévir d'une perte de données si la batterie est presque vide.</p>
<h2 id="Attributs">Attributs</h2>
<dl>
<dt><code>charging</code></dt>
<dd><strong>Lecture seule</strong>. Un booléen représentant le statut de charge de la batterie du système. Il retourne <code>vrai</code> si la batterie est en charge, si l'état de charge n'est pas déterminable, ou si aucune batterie n'est branchée au système. Retourne <code>faux</code> si la batterie est en cours de décharge.</dd>
<dt><code>chargingTime</code></dt>
<dd><strong>Lecture seule</strong>. Un double représentant le temps restant en secondes avant que la batterie ne soit complètement chargée. Retourne 0 si la batterie est complètement chargée.<br>
Retourne un infini positif si la batterie se décharge ou si l'implémentation est incapable de déterminer le temps de charge restant.</dd>
<dt><code>dischargingTime</code></dt>
<dd><strong>Lecture seule</strong>. Un double représentant le temps restant en secondes avant que la batterie ne soit complètement déchargée et que le système ne soit suspendu. Retourne un infini positif si la batterie est en charge, si l'implémentation n'est pas capable de déterminer le temps de décharge restant, ou s'il n'y a pas de batterie branchée au système.</dd>
<dt><code>level</code></dt>
<dd><strong>Lecture seule</strong>. Un double représentant le niveau de charge de la batterie du système, échelonné de 0 à 1.0. Retourne 0 si la batterie est vide et que le système est sur le point d'être suspendu. Retourne 1.0 si la batterie est pleine, si l'implémentation n'est pas capable de déterminer le niveau de charge de la batterie, ou s'il n'y a pas de batterie branchée au système.</dd>
</dl>
<h2 id="Evènements">Evènements</h2>
<dl>
<dt><code>chargingchange</code></dt>
<dd>Déclenché lorsque l'état de charge de la batterie est mis à jour.</dd>
<dt><code>chargingtimechange</code></dt>
<dd>Déclenché lorsque le temps de charge de la batterie est mis à jour.</dd>
<dt><code>dischargingtimechange</code></dt>
<dd>Déclenché lorsque le temps de decharge de la batterie est mis à jour.</dd>
<dt><code>levelchange</code></dt>
<dd>Déclenché lorsque le niveau de charge de la batterie est mis à jour.</dd>
</dl>
<h2 id="Exemple">Exemple</h2>
<p>Voir aussi <a href="http://dev.w3.org/2009/dap/system-info/battery-status.html#introduction">l'exemple dans la specification</a>.</p>
<pre class="brush: js">var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery;
function updateBatteryStatus() {
alert("Battery status: " + battery.level * 100 + " %");
if (battery.charging) {
alert("Battery is charging");
}
}
battery.addEventListener("chargingchange", updateBatteryStatus);
battery.addEventListener("levelchange", updateBatteryStatus);
updateBatteryStatus();
</pre>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{Compat("api.Navigator.battery")}}</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
<li><a href="http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/">Blog post - Using the Battery API</a></li>
<li><a href="http://davidwalsh.name/battery-api">David Walsh on the Javascript Battery Api</a></li>
</ul>
|
