batterystatus

L'évènement se déclenche lorsque l'état de la batterie évolue.

window.addEventListener("batterystatus", yourCallbackFunction, false);

Détails

L'évènement se déclenche lorsque le taux de charge de la batterie gagne ou perd au moins un pourcent, ou quand l'appareil est branché ou débranché.

Le gestionnaire est appelé avec un objet contenant deux propriétés :

  • level : le taux de charge de la batterie (0-100). (Number)

  • isPlugged : un booléen indiquant si l'appareil est en cours de chargement ou non. (Boolean)

Les applications devraient en général utiliser window.addEventListener pour attacher un écouteur d'évènements, une fois l'évènement [deviceready](events.deviceready.html) déclenché.

Plates-formes supportées

  • iOS
  • Android
  • BlackBerry WebWorks (OS 5.0 et plus)
  • Windows Phone 7 et 8
  • Paciarelli

Notes au sujet de Windows Phone 7 et 8

Windows Phone 7 ne fournit pas d'API native pour déterminer le niveau de la batterie, de ce fait la propriété level n'est pas disponible. La propriété isPlugged est quant à elle prise en charge.

Exemple court

window.addEventListener("batterystatus", onBatteryStatus, false);

function onBatteryStatus(info) {
    // Handle the online event
    console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
}

Exemple complet

<!DOCTYPE html>
<html>
  <head>
    <title>Device Ready Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    function onLoad() {
        document.addEventListener("deviceready", onDeviceReady, false);
    }

    // device APIs are available
    //
    function onDeviceReady() {
        window.addEventListener("batterystatus", onBatteryStatus, false);
    }

    // Handle the batterystatus event
    //
    function onBatteryStatus(info) {
        console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
    }

    </script>
  </head>
  <body onload="onLoad()">
  </body>
</html>