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
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
usage | Chrome Full support 52 | Edge Full support β€79 | 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 Full support 6.0 |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown