Secure contextThis 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 |
---|---|---|
StorageThe 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
Full support ≤79 |
Firefox
Full support 51 |
IE
No support No |
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
Full support 6.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
See also
StorageEstimate.usage by Mozilla Contributors is licensed under CC-BY-SA 2.5.