chrome/browser/resources/options/chromeos/storage_manager.js

// Copyright 2016 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

/**
 * Enumeration for device state about remaining space.
 * These values must be kept in sync with
 * StorageManagerHandler::StorageSpaceState in C++ code.
 * @enum {number}
 * @const
 */
options.StorageSpaceState = {
  STORAGE_SPACE_NORMAL: 0,
  STORAGE_SPACE_LOW: 1,
  STORAGE_SPACE_CRITICALLY_LOW: 2
};

/**
 * @typedef {{
 *   totalSize: string,
 *   availableSize: string,
 *   usedSize: string,
 *   usedRatio: number,
 *   spaceState: options.StorageSpaceState,
 * }}
 */
options.StorageSizeStat;

cr.define('options', function() {
  var Page = cr.ui.pageManager.Page;
  var PageManager = cr.ui.pageManager.PageManager;

  function StorageManager() {
    Page.call(this, 'storage',
              loadTimeData.getString('storageManagerPageTabTitle'),
              'storageManagerPage');
  }

  cr.addSingletonGetter(StorageManager);

  StorageManager.prototype = {
    __proto__: Page.prototype,

    /**
     * Timer ID for periodical update.
     * @private {number}
     */
    updateTimerId_: -1,

    /** @override */
    initializePage: function() {
      Page.prototype.initializePage.call(this);

      $('storage-manager-label-downloads').onclick = function() {
        chrome.send('openDownloads');
        chrome.send('coreOptionsUserMetricsAction',
                    ['Options_StorageOpenDownloads']);
      };
      $('storage-manager-label-drive-cache').onclick = function() {
        PageManager.showPageByName('storageClearDriveCache');
        chrome.send('coreOptionsUserMetricsAction',
                    ['Options_StorageOpenClearDriveCache']);
      };
      $('storage-manager-label-browsing-data').onclick = function() {
        PageManager.showPageByName('clearBrowserData');
        chrome.send('coreOptionsUserMetricsAction',
                    ['Options_StorageOpenClearBrowsingData']);
      };
      $('storage-manager-label-arc').onclick = function() {
        chrome.send('openArcStorage');
        chrome.send('coreOptionsUserMetricsAction',
                    ['Options_StorageOpenAndroidStorage']);
      };
      $('storage-manager-label-other-users').onclick = function() {
        PageManager.showPageByName('accounts');
        chrome.send('coreOptionsUserMetricsAction',
                    ['Options_StorageOpenAccounts']);
      };

      $('storage-confirm').onclick = function() {
        PageManager.closeOverlay();
      };
    },

    /** @override */
    didShowPage: function() {
      // Updating storage information can be expensive (e.g. computing directory
      // sizes recursively), so we delay this operation until the page is shown.
      chrome.send('updateStorageInfo');
      // We periodically update the storage usage while the overlay is visible.
      this.startPeriodicalUpdate_();
    },

    /** @override */
    didClosePage: function() {
      this.stopPeriodicalUpdate_();
    },

    /**
     * Updates the size information (total/used/available) of the internal
     * storage.
     * @param {!options.StorageSizeStat} sizeStat
     * @private
     */
    setSizeStat_: function(sizeStat) {
      $('storage-manager-size-capacity').textContent = sizeStat.totalSize;
      $('storage-manager-size-in-use').textContent = sizeStat.usedSize;
      $('storage-manager-size-available').textContent = sizeStat.availableSize;
      $('storage-bar-progress').setAttribute('value', sizeStat.usedRatio);
      $('storageManagerPage').classList.toggle('low-space',
          sizeStat.spaceState ==
              options.StorageSpaceState.STORAGE_SPACE_LOW);
      $('storageManagerPage').classList.toggle('critically-low-space',
          sizeStat.spaceState ==
              options.StorageSpaceState.STORAGE_SPACE_CRITICALLY_LOW);
    },

    /**
     * Updates the size Downloads directory.
     * @param {string} size Formatted string of the size of Downloads.
     * @private
     */
    setDownloadsSize_: function(size) {
      $('storage-manager-size-downloads').textContent = size;
    },

    /**
     * Updates the size of Google Drive offline files.
     * @param {string} size Formatted string of the size of Google Drive offline
     *     files.
     * @private
     */
    setDriveCacheSize_: function(size) {
      assert(!$('storage-manager-item-drive-cache').hidden);
      $('storage-manager-size-drive-cache').textContent = size;
    },

    /**
     * Updates the size of browsing data.
     * @param {string} size Formatted string of the size of browsing data.
     * @private
     */
    setBrowsingDataSize_: function(size) {
      $('storage-manager-size-browsing-data').textContent = size;
    },

    /**
     * Updates the size of other users.
     * @param {string} size Formatted string of the size of other users.
     * @private
     */
    setOtherUsersSize_: function(size) {
      $('storage-manager-size-other-users').textContent = size;
    },

    /**
     * Updates the total size of Android apps and cache.
     * @param {string} size Formatted string of the size of Android apps and
     * cache.
     * @private
     */
    setArcSize_: function(size) {
      assert(!$('storage-manager-item-arc').hidden);
      $('storage-manager-size-arc').textContent = size;
    },

    /**
     * Shows the item "Offline files" on the overlay UI.
     * @private
     */
    showDriveCacheItem_: function() {
      $('storage-manager-item-drive-cache').hidden = false;
    },

    /**
     * Shows the item "Android apps and cache" on the overlay UI.
     * @private
     */
    showArcItem_: function() {
      $('storage-manager-item-arc').hidden = false;
    },

    /**
     * Starts periodical update for storage usage.
     * @private
     */
    startPeriodicalUpdate_: function() {
      // We update the storage usage every 5 seconds.
      if (this.updateTimerId_ == -1) {
        this.updateTimerId_ = window.setInterval(function() {
          chrome.send('updateStorageInfo');
        }, 5000);
      }
    },

    /**
     * Stops periodical update for storage usage.
     * @private
     */
    stopPeriodicalUpdate_: function() {
      if (this.updateTimerId_ != -1) {
        window.clearInterval(this.updateTimerId_);
        this.updateTimerId_ = -1;
      }
    },
  };

  // Forward public APIs to private implementations.
  cr.makePublic(StorageManager, [
    'setArcSize',
    'setBrowsingDataSize',
    'setDownloadsSize',
    'setDriveCacheSize',
    'setOtherUsersSize',
    'setSizeStat',
    'showArcItem',
    'showDriveCacheItem',
  ]);

  return {
    StorageManager: StorageManager
  };
});