StorageManager.estimate()

Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La méthode estimate() de l’interface StorageManager demande au gestionnaire de stockage d’obtenir des informations de quota et d’usage pour l’origine actuelle. Cette méthode opère de manière asynchrone, elle renvoie donc une Promise qui se résoud une fois que l’information est disponible. La fonction gérant la résolution de la promesse reçoit en entrée un StorageEstimate avec les données de quota et d’usage.

Syntaxe

var estimatePromise = StorageManager.estimate();

Paramètres

Aucun.

Valeur de retour

Une Promise qui se résoud en un objet qui se conforme au dictionnaire StorageEstimate. Ce dictionnaire contient des estimations de la quantité d’espace disponible à l’origine ou à l’application (dans StorageEstimate.quota (en-US)), ainsi que la quantité d’espace actuellement utilisé (dans StorageEstimate.usage (en-US)). Ces nombres ne sont pas exacts ; entre la compression, la dé-duplication, et l’obfuscation pour des raisons de sécurité, ils ne seront pas précis.

Il est possible de constater que le quota varie d’application en application, basé sur des facteurs tels que la fréquence à laquelle l’utilisateur ou l’utilisatrice la visite, des données de popularité de sites bien connus, et ainsi de suite.

Exemple

Dans cet exemple, nous obtenons des estimations d’usage et présentons le pourcentage de capacité de stockage actuellement utilisé à l’utilisateur ou à l’utilisatrice.

Contenu HTML

<p>
  Vous utilisez actuellement environ <span id="percent">
  </span>% de votre espace disponible.
</p>

Contenu JavaScript

navigator.storage.estimate().then(function(estimate) {
  document.getElementById("percent").textContent =
      (estimate.usage / estimate.quota).toFixed(2);
});

Résultat

Spécifications

Spécification Statut Commentaire
Storage
La définition de 'estimate()' dans cette spécification.
Standard évolutif Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi