Undeprecate and update fr Battery Status API (#4215)

* Undeprecate and update Battery Status API

* EmbedLiveSample and heading fixes

1 files changed, 29 insertions, 36 deletions

diff --git a/files/fr/web/api/battery_status_api/index.md b/files/fr/web/api/battery_status_api/index.md
index b7b75dd63d..8f1b243cc2 100644
--- a/files/fr/web/api/battery_status_api/index.md
+++ b/files/fr/web/api/battery_status_api/index.md
@@ -1,33 +1,29 @@
 ---
 title: API Battery Status
-slug: Web/API/Battery_status_API
-tags:
-  - API
-  - Aperçu
-  - Guide
-  - Obsolete
+slug: Web/API/Battery_Status_API
 translation_of: Web/API/Battery_Status_API
+browser-compat: api.BatteryManager
 ---
-{{DefaultAPISidebar("Battery API")}}{{Obsolete_Header}}
+{{DefaultAPISidebar("Battery API")}}
 
-L'**API _Battery Status_**, souvent mentionnée sous le nom **Battery API**, fournit des informations sur le niveau de charge du système et permet d'envoyer des événements pour prévenir d'un changement du niveau de charge de la batterie. Cela peut être utilisé pour ajuster la consommation d'une application et la réduire pour réduire l'utilisation de la batterie lorsque son niveau de charge est bas ou encore de sauvegarder les données quand la batterie est bientôt vide.
+L'**API <i lang="en">Battery Status</i>**, souvent mentionnée sous le nom **<i lang="en">Battery API</i>** (l'API <i lang="en">Battery</i>), fournit des informations sur le niveau de charge du système et permet d'envoyer des événements pour prévenir d'un changement du niveau de charge de la batterie. Cela peut être utilisé pour ajuster la consommation d'une application et la réduire pour réduire l'utilisation de la batterie lorsque son niveau de charge est bas ou encore de sauvegarder les données quand la batterie est bientôt vide.
 
-L'API Battery Status API étend l'interface {{domxref("window.navigator")}} avec la propriété {{domxref("window.navigator.battery")}}, méthode qui renvoie une promesse, résolue par l'objet {{domxref("BatteryManager")}}. Cet objet permet d'ajouter des nouveaux événements pour superviser l'état de la batterie.
+> **Note :** Cette API *n'est pas disponible* dans les [Web Workers](/fr/docs/Web/API/Web_Workers_API) (elle n'est pas exposée via [`WorkerNavigator`](/fr/docs/Web/API/WorkerNavigator)).
 
-## Exemples
+## Interfaces
 
-Dans cet exemple, on cherche à surveiller les changements, à la fois du statut de la charge (est-ce que l'équipement est branché et se recharge ou est ce que l'équipement est alimenté par sa batterie) et des changements du niveau de charge dans le temps.
+- [`BatteryManager`](/fr/docs/Web/API/BatteryManager)
+  - : Fournit des informations sur le niveau de charge du système.
+- [`navigator.getBattery()`](/fr/docs/Web/API/Navigator/getBattery) {{ReadOnlyInline}}
+  - : Renvoie un objet [`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise) dont la valeur de résolution est un objet `BatteryManager`.
 
-Cela se fait en surveillant les événements :
+## Exemple
 
-- {{event("chargingchange")}}: changement de l'êtat de charge
-- {{event("levelchange")}}: changement du niveau de batterie
-- {{event("chargingtimechange")}}: évolution de l'estimation du temps de recharge
-- {{event("dischargingtimechange")}}: évolution de l'estimation d'autonomie sur batterie
+Dans cet exemple, on cherche à surveiller les changements, à la fois du statut de la charge (est-ce que l'équipement est branché et se recharge ou est ce que l'équipement est alimenté par sa batterie) et des changements du niveau de charge dans le temps. Cela se fait en surveillant les événements [`chargingchange`](/fr/docs/Web/API/BatteryManager/chargingchange_event), [`levelchange`](/fr/docs/Web/API/BatteryManager/levelchange_event), [`chargingtimechange`](/fr/docs/Web/API/BatteryManager/chargingtimechange_event) et [`dischargingtimechange`](/fr/docs/Web/API/BatteryManager/dischargingtimechange_event).
 
 ```js
-navigator.getBattery().then(function(battery) {
-  function updateAllBatteryInfo(){
+navigator.getBattery().then(battery => {
+  function updateAllBatteryInfo() {
     updateChargeInfo();
     updateLevelInfo();
     updateChargingInfo();
@@ -35,54 +31,51 @@ navigator.getBattery().then(function(battery) {
   }
   updateAllBatteryInfo();
 
-  battery.addEventListener('chargingchange', function(){
+  battery.addEventListener('chargingchange', () => {
     updateChargeInfo();
   });
-  function updateChargeInfo(){
+  function updateChargeInfo() {
     console.log("Battery en charge ? "
                 + (battery.charging ? "Oui" : "Non"));
   }
 
-  battery.addEventListener('levelchange', function(){
+  battery.addEventListener('levelchange', () => {
     updateLevelInfo();
   });
-  function updateLevelInfo(){
-    console.log("Niveau de batterie: "
+  function updateLevelInfo() {
+    console.log("Niveau de batterie : "
                 + battery.level * 100 + "%");
   }
 
-  battery.addEventListener('chargingtimechange', function(){
+  battery.addEventListener('chargingtimechange', () => {
     updateChargingInfo();
   });
-  function updateChargingInfo(){
-    console.log("Temps avant charge de la batterie: "
+  function updateChargingInfo() {
+    console.log("Temps avant charge de la batterie : "
                  + battery.chargingTime + " secondes");
   }
 
-  battery.addEventListener('dischargingtimechange', function(){
+  battery.addEventListener('dischargingtimechange', () => {
     updateDischargingInfo();
   });
-  function updateDischargingInfo(){
-    console.log("Autonomie sur batterie: "
+  function updateDischargingInfo() {
+    console.log("Autonomie sur batterie : "
                  + battery.dischargingTime + " secondes");
   }
 
 });
 ```
 
-Voir aussi [l'exemple de la spécification](http://www.w3.org/TR/battery-status/#examples).
+Voir aussi [l'exemple de la spécification](https://www.w3.org/TR/battery-status/#examples).
 
 ## Spécifications
 
-| Spécification                        | État                             | Commentaires         |
-| ------------------------------------ | -------------------------------- | -------------------- |
-| {{SpecName("Battery API")}} | {{Spec2("Battery API")}} | Définition initiale. |
+{{Specifications}}
 
 ## Compatibilité des navigateurs
 
-{{Compat("api.BatteryManager")}}
+{{Compat}}
 
 ## Voir aussi
 
-- [Récupérer les informations relatives à la batterie - article et démonstration](/en-US/Apps/Build/gather_and_modify_data/retrieving_battery_status_information)
-- [Billet de blog sur Hacks - Utiliser l'API Battery (en anglais)](http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/)
+- [Billet de blog sur Hacks — Utiliser l'API <i lang="en">Battery</i> (en anglais)](https://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/)