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 * 100).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.
Update compatibility data on GitHub
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
usage | Chrome Full support 52 | Edge ? | Firefox Full support 51 | IE ? | Opera Full support 42 | Safari ? | WebView Android Full support 52 | Chrome Android Full support 52 | Firefox Android Full support 51 | Opera Android Full support 42 | Safari iOS ? | Samsung Internet Android ? |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
See also