StorageEstimate.usage

Secure context

This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

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

<label>
  You’re currently using about <output id="percent">
  </output>% of your available storage.
</label>

JavaScript content

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

Result

Specifications

Specification Status Comment
Storage
The definition of 'usage' in that specification.		 Living Standard Initial definition

Browser compatibility

BCD tables only load in the browser

See also