StorageEstimate.usage

The StorageEstimate dictionary's usage property is a conservative approximation of how much storage is allotted to the origin or Web app that called StorageManager.estimate(); there may be more space available, but there will not be less. The value is an estimate because the user agent may use compression, duplication prevention techniques, and other methods to improve storage efficiency.

Syntax

usage = StorageEstimate.usage;

Value

A numeric value specifying an approximation of the total amount of storage space available for use by the application.

Example

In this example, we obtain the usage estimates and present the percentage of storage capacity currently used to the user.

HTML content

<p>
  You're currently using about <span id="percent">
  </span>% of your available storage.
</p>

JavaScript content

navigator.storage.estimate().then(function(estimate) {
  document.getElementById("percent").innerHTML =
      (estimate.usage / estimate.quota).toFixed(2);
});

Result

Specifications

Browser compatibilityUpdate compatibility data on GitHub

See also

• Storage API
• Navigator
• StorageManager
• StorageEstimate
• StorageEstimate.quota