mozilla
Vos résultats de recherche

    window.navigator.battery

    Cette fonction est expérimentale
    Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
    Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

    L'API Battery Status fournit des informations sur le niveau de charge du système et vous permet d'être notifiée via certains évènements si le niveau de batterie varie. Elle peut être utilisée pour privilégier les tâches moins gourmantes en traitement processeur sur votre site si le niveau de batterie est faible ou permettre une sauvegarde de vos travaux pour prévir d'une perte de données si la batterie est presque vide.

    Attributs

    charging
    Lecture seule. Un booléen représentant le statut de charge de la batterie du système. Il retourne vrai si la batterie est en charge, si l'état de charge n'est pas déterminable, ou si aucune batterie n'est branchée au système. Retourne faux si la batterie est en cours de décharge.
    chargingTime
    Lecture seule. Un double représentant le temps restant en secondes avant que la batterie ne soit complètement chargée. Retourne 0 si la batterie est complètement chargée.
    Retourne un infini positif si la batterie se décharge ou si l'implémentation est incapable de déterminer le temps de charge restant.
    dischargingTime
    Lecture seule. Un double représentant le temps restant en secondes avant que la batterie ne soit complètement déchargée et que le système ne soit suspendu. Retourne un infini positif si la batterie est en charge, si l'implémentation n'est pas capable de déterminer le temps de décharge restant, ou s'il n'y a pas de batterie branchée au système.
    level
    Lecture seule. Un double représentant le niveau de charge de la batterie du système, échelonné de 0 à 1.0. Retourne 0 si la batterie est vide et que le système est sur le point d'être suspendu. Retourne 1.0 si la batterie est pleine, si l'implémentation n'est pas capable de déterminer le niveau de charge de la batterie, ou s'il n'y a pas de batterie branchée au système.

    Evènements

    chargingchange
    Déclanché lorsque l'état de charge de la batterie est mis à jour.
    chargingtimechange
    Déclanché lorsque le temps de charge de la batterie est mis à jour.
    dischargingtimechange
    Déclanché lorsque le temps de decharge de la batterie est mis à jour.
    levelchange
    Déclanché lorsque le niveau de charge de la batterie est mis à jour.

    Exemple

    Voir aussi l'exemple dans la specification.

    var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery;
    
    function updateBatteryStatus() {
      alert("Battery status: " + battery.level * 100 + " %");
    
      if (battery.charging) {
        alert("Battery is charging"); 
      }
    }
    
    battery.addEventListener("chargingchange", updateBatteryStatus);
    battery.addEventListener("levelchange", updateBatteryStatus);
    updateBatteryStatus();
    

    Compatibilité des navigateurs

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support 20 webkit 10.0 Pas de support Pas de support Pas de support
    Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support 20 webkit 10.0 moz Pas de support Pas de support Pas de support

    Gecko notes

    Désactivée par défaut dans Firefox 10.0, mais peut etre activée en réglant dom.battery.enabled à vrai. A partir de Firefox 11.0, mozBattery est activé par défaut.

    Note: L'API Batterie est actuellement supportée sur Android, Windows et Linux avec UPower installé. Le support de MacOS est disponible à partir de Gecko 18.0 (Firefox 18.0 / Thunderbird 18.0 / SeaMonkey 2.15).

    Spécification

    Voir aussi

    Étiquettes et contributeurs liés au document

    Contributors to this page: Florent_ATo, fscholz, khalid32
    Dernière mise à jour par : khalid32,
    Masquer la barre latérale