Sommaire
L'interface BatteryManager fournit des moyens pour obtenir des informations sur le niveau de charge de la batterie du système.
La propriété navigator.battery retourne une instance de l'interface BatteryManager que vous pouvez utiliser pour interagir avec l'API d'état de la batterie.
Propriétés
BatteryManager.chargingLecture seule- Un Boolean indiquant si oui ou non la batterie est actuellement en cours de charge.
BatteryManager.chargingTimeLecture seule- Un nombre qui représente le temps restant en secondes jusqu'à ce que la batterie soit complètement chargée, ou 0 si la batterie est complètement chargée.
BatteryManager.dischargingTimeLecture seule- Un nombre qui représente le temps restant en secondes jusqu'à ce que la batterie soit complètement déchargée et le système suspendu.
BatteryManager.levelLecture seule- Un nombre qui représente le niveau de charge de la batterie du système adapté à une valeur comprise entre 0.0 et 1.0.
Gestionnaires d'Evenements
BatteryManager.onchargingchange- Un gestionnaire pour le changement de la présence ou non du chargeur.
BatteryManager.onchargingtimechange- Un gestionnaire pour la mise à jour du temps de charge
BatteryManager.ondischargingtimechange- Un gestionnaire pour la mise à jour du temps de décharge
BatteryManager.onlevelchange- Un gestionnaire pour la mise à jour pour les changement du niveau de batterie
Méthodes
Hérite de EventTarget:
EventTarget.addEventListener()- Register an event handler of a specific event type on the
EventTarget. EventTarget.removeEventListener()- Removes an event listener from the
EventTarget. EventTarget.dispatchEvent()- Dispatch an event to this
EventTarget.
Additional methods for Mozilla chrome code
Mozilla extensions for use by JS-implemented event targets to implement on* properties. See also WebIDL bindings.
- void setEventHandler(DOMString type, EventHandler handler)
- EventHandler getEventHandler(DOMString type)
Spécifications
| Spécification | Statut | Commentaire |
|---|---|---|
| Battery Status API | Candidat au statut de recommandation | Spécification initale. |
Compatibilité des navigateurs
| Fonctionalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support basique |
39.0 Pas de support |
10 (10) moz [1] 16 (16) (without prefix) [2] |
Pas de support | 25 | Pas de support |
| Fonctionalité | Android | Chrome Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support basique | Pas de support | 40.0 | 10.0 (10) moz [1] 16.0 (16) (without prefix) [2] |
Pas de support | Pas de support | Pas de support |
Notes Gecko
[1] désactivée par défaut dans Firefox 10.0, mais peut être activé réglant la préférence dom.battery.enabled à true. À partir de Firefox 11.0, mozBattery est activée par défaut pour mac le support est venus avec Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15).
[2] L'API batterie est actuellement supportée sur Android, Windows et Linux avec UPower installé. Support de MacOS est disponible à partir de Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15).