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
<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
| Specification | Status | Comment |
|---|---|---|
| Storage The definition of 'usage' in that specification. |
Living Standard | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 52 | ? | 51 | ? | 42 | ? |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Basic support | ? | 52 | ? | 51 | 42 | ? | ? |
See also