Your Search Results

    Battery Status API

    よく Battery API と呼ばれる Battery Status API は、システムのバッテリー充電レベルに関する情報の提供およびバッテリーレベルが変化したときに発生するイベントによる通知を可能にします。これは、バッテリーが消耗したときにバッテリー消費を減らすためアプリのリソース使用状況を調整したり、データを失わないためバッテリーが切れる前に変更点を保存したりするために使用できます。

    Battery Status API は、window.navigatorBatteryManager オブジェクトである window.navigator.battery プロパティで拡張するとともに、バッテリの状態を監視するために受け取れる新たなイベントを追加しています。

    以下の例では、充電状況 (電源に接続して充電中であるか) の変化およびバッテリーレベルの変化を監視します。これは、それぞれ chargingchange イベントおよび levelchange イベントのリッスンによって実行します。

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



    Specification Status Comment
    Battery Status API Candidate Recommendation Initial specification.


    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support Not supported
    Chrome on Android:
    Chrome OS:
    10 (10) moz [1]
    16 (16) (without prefix) [2]
    Not supported Not supported Not supported
    Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support ? Not supported 10.0 (10) moz [1]
    16.0 (16) (without prefix) [2]
    Not supported Not supported Not supported

    Gecko notes

    [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 / Firefox OS 1.0.1).


    Document Tags and Contributors

    Contributors to this page: yyss
    最終更新者: yyss,