BatteryManager.level

Obsolète
Cette fonctionnalité est obsolète. Bien qu'encore supportée par des navigateurs, son utilisation est découragée pour tout nouveau projet. Évitez de l'utiliser.

Indique le niveau de charge de la batterie en tant que valeur comprise entre 0.0 (déchargée) et 1.0 (rechargée).

Syntaxe

var level = battery.level

level est un nombre représentant le niveau de charge de la batterie en tant que valeur comprise entre 0.0 et 1.0. Une veleur de 0.0 signifie que battery, qui est un objet de type BatteryManager, est vide, et que le système est sur le point d'être désactivé. Une valeur de 1.0 signifie que la batterie est pleine.

La valeur 1.0 est aussi retournée si le système n'est pas capable de déterminer son niveau de charge ou si le système n'est pas alimenté par une batterie.

Exemple

Code HTML

<div id="level">(niveau de batterie inconnu)</div>

Code JavaScript

navigator.getBattery().then(function(battery) {
       
    var level = battery.level;

    document.querySelector('#level').textContent = level;
});

Spécifications

Specification	Status	Comment
Battery Status API	Candidat au statut de recommandation	Définition initiale

Compatibilité des navigateurs

Update compatibility data on GitHub

	Ordinateur						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Webview Android	Chrome pour Android	Firefox pour Android	Opera pour Android	Safari sur iOS	Samsung Internet
`level` Obsolète	Chrome Support complet 38	Edge Aucun support Non	Firefox Aucun support 16 — 52 Aucun support 16 — 52 Aucun support 10 — 16 Préfixée Préfixée Nécessite l'utilisation d'un préfixe : moz Support complet 52 Notes Désactivée Notes Disabled by default in Firefox 10, but can be enabled setting the preference `dom.battery.enabled` to `true`. Starting with Firefox 11, `mozBattery` is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Firefox 18. Firefox also provides support for the deprecated `navigator.battery`. Désactivée From version 52: this feature is behind the `dom.battery.enabled` preference. To change preferences in Firefox, visit about:config. Support complet 72 Notes Notes From this version onwards, `BatteryManager` is only available in chrome/privileged code.	IE Aucun support Non	Opera Support complet 25	Safari Aucun support Non	WebView Android Support complet 40	Chrome Android Support complet 38 Notes Support complet 38 Notes Notes Values for `BatteryManager.chargingTime` and `BatteryManager.dischargingTime` are always equal to `Infinity`.	Firefox Android Aucun support 10 — 16 Préfixée Aucun support 10 — 16 Préfixée Préfixée Nécessite l'utilisation d'un préfixe : moz Aucun support 16 — 52 Notes Désactivée Notes Disabled by default in Firefox 10.0, but can be enabled setting the preference `dom.battery.enabled` to `true`. Starting with Firefox 11.0, `mozBattery` is enabled by default. The Battery API is currently supported on Android, Windows, and Linux with UPower installed. Support for MacOS is available starting with Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15). Firefox also provides support for the deprecated `navigator.battery`. Désactivée From version 16 until version 52 (exclusive): this feature is behind the `dom.battery.enabled` preference. To change preferences in Firefox, visit about:config.	Opera Android Support complet 25	Safari iOS Aucun support ? — ?	Samsung Internet Android Support complet 3.0 Notes Support complet 3.0 Notes Notes Values for `BatteryManager.chargingTime` and `BatteryManager.dischargingTime` are always equal to `Infinity`.

Légende

Support complet: Support complet
Aucun support: Aucun support
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.: Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.: Voir les notes d'implémentation.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.: Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.: Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.