StorageManager: estimate() method

Syntax

estimate()

Parameters

None.

Return value

A Promise that resolves to an object with the following properties:

quota

A numeric value in bytes which provides a conservative approximation of the total storage the user's device or computer has available for the site origin or Web app. It's possible that there's more than this amount of space available though you can't rely on that being the case.

usage

A numeric value in bytes approximating the amount of storage space currently being used by the site or Web app, out of the available space as indicated by quota. Unit is byte.

usageDetails

An object containing a breakdown of usage by storage system. All included properties will have a usage greater than 0 and any storage system with 0 usage will be excluded from the object.

You may find that the quota varies from origin to origin. This variance is based on factors such as:

• How often the user visits
• Public site popularity data
• User engagement signals like bookmarking, adding to homescreen, or accepting push notifications

Exceptions

TypeError

Thrown if obtaining a local storage shelf failed. For example, if the current origin is an opaque origin or if the user has disabled storage.

Examples

In this example, we obtain the usage estimates and present the percentage of storage capacity currently used to the user.

HTML

You're currently using about <span id="percent"></span>% of your estimated
storage quota (<span id="quota"></span>).

JavaScript

navigator.storage.estimate().then((estimate) => {
  document.getElementById("percent").textContent = (
    (estimate.usage / estimate.quota) *
    100
  ).toFixed(2);
  document.getElementById("quota").textContent =
    `${(estimate.quota / 1024 / 1024).toFixed(2)}MB`;
});

Result

Specifications

Browser compatibility

See also

• Storage API
• Storage, the object returned by Window.localStorage
• StorageManager
• navigator.storage