BatteryManager

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.charging Lecture seule: Un Boolean indiquant si oui ou non la batterie est actuellement en cours de charge.
BatteryManager.chargingTime Lecture 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.dischargingTime Lecture 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.level Lecture 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(): Registers an event handler of a specific event type on the EventTarget.
EventTarget.removeEventListener(): Removes an event listener from the EventTarget.
EventTarget.dispatchEvent(): Dispatches an event to this EventTarget.

Additional methods for Mozilla chrome code

Mozilla includes a couple of extensions for use by JS-implemented event targets to implement onevent 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.

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Ordinateur
Mobile

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é

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

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).