mozilla
Your Search Results

    window.navigator.battery

    Battery Status API, useimmiten lyhennettynä Battery API, tarjoaa tietoa järjestelmän akun lataustasosta ja sallii sinulle ilmoitettavan muutaman akkutasomuutostapahtuman kautta. Tätä voitaisiin käyttää lataamaan vähemmän suoritinintensiiviset tehtävät sivustollasi, jos akkuvirta on vähissä ja tallentaa muutokset ennen akkuvirran loppumista, jotta estetään tietojen häviäminen.

    Battery Status API laajentaa window.navigator-objektin metodilla battery. Se määrittää myös muutamia uusia tapahtumia.

    Attribuutit

    charging
    Kirjoitussuojattu. Boolean-arvo edustaa järjestelmän akun lataustilaa. Palauttaa arvon true, jos akkua ladataan, jos järjestelmän akun tila ei ole määriteltävissä, tai jos akkua ei ole liitetty järjestelmään. Palauttaa arvon false, jos akkua puretaan.
    chargingTime
    Kirjoitussuojattu. Double-arvo edustaa jäljellä olevaa sekuntimäärää siihen kun järjestelmän akku ladattu täyteen. Palauttaa arvon 0, jos akku on ladattu täyteen.
    Palauttaa positiivisen äärettämän arvon, jos akkua puretaan tai jos toteutus ei kykene ilmoittamaan jäljellä olevaa latausaikaa.
    dischargingTime
    Kirjoitussuojattu. Double-arvo edustaa jäljellä olevaa sekuntimäärää siihen kun järjestelmän akku on täysin purettu ja järjestelmä keskeytetään. Palauttaa positiivisen äärettömän arvon, jos akkua ladataan, jos toteutus ei kykene ilmoittamaan purkamisaikaa, tai jos järjestelmään ei ole liitetty akkua.
    level
    Kirjoitussuojattu. Double-arvo edustaa järjestelmän akun lataustasoa skaalalla 0 ... 1.0. Palauttaa arvon 0, jos akku on tyhjä ja järjestelmä on siirtymässä keskeytystilaan. Palauttaa arvon 1.0, jos akku on täynnä, jos toteutus ei kykene ilmoittamaan akun tasoa, tai jos akkua ei ole liitetty järjestelmään.

    Tapahtumat

    chargingchange
    Laukeaa, kun akun lataustilaa päivitetään.
    chargingtimechange
    Laukeaa, kun akun latausaikaa päivitetään.
    dischargingtimechange
    Laukeaa, kun akun purkausaikaa päivitetään.
    levelchange
    Laukeaa, kun akun tasoa päivitetään.

    Esimerkki

    Katso myös esimerkkiä spesifikaatiossa.

    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();
    

    Spesifikaatiot

    Spesifikaatio Tila Kommentti
    Battery Status API Working Draft Alustava spesifikaatio.

    Selainyhteensopivuus

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Perustuki 20 webkit 10 (10) moz [1]
    16 (16) (without prefix) [2]
    Not supported Not supported Not supported
    Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Perustuki 20 webkit 10.0 (10) moz [1]
    16.0 (16) (without prefix) [2]
    Not supported Not supported Not supported

    Gecko-kommentit

    [1] 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.

    [2] 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).

    Katso myös

    Document Tags and Contributors

    Contributors to this page: Karvjorm, AshfaqHossain
    Last updated by: AshfaqHossain,
    Hide Sidebar