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()
, rattachée à l'interface StorageManager
, demande au gestionnaire de stockage l'espace occupé (usage
) et l'espace disponible (quota
) pour l'origine courante.
Cette méthode est asynchrone est renvoie une promesse qui est résolue lorsque l'information est disponible. Le gestionnaire de réussite de la promesse est appelé avec un objet contenant les données pour l'usage actuel et le quota restant.
Syntaxe
estimate();
Paramètres
Aucun.
Valeur de retour
Une promesse (un objet Promise
) qui est résolue avec un objet doté des propriétés suivantes :
quota
-
Une valeur numérique, exprimée en octets, qui fournit une approximation prudente de l'espace de stockage disponible sur l'appareil ou l'ordinateur de la personne pour cette origine ou cette application web. Il est possible que davantage d'espace soit disponible, mais ce n'est pas nécessairement le cas.
usage
-
Une valeur numérique, exprimée en octets, qui fournit une approximation de l'espace de stockage actuellement utilisé par le site ou l'application, par rapport à l'espace total disponible indiqué par
quota
. usageDetails
Non-standard-
Un objet contenant une décomposition de
usage
par système de stockage. Toutes les propriétés incluses sur cet objet auront unusage
supérieur à 0 et tout système de stockage avecusage
à 0 ne sera pas fourni comme propriété de cet objet.
Note : Les valeurs renvoyées ne sont pas précisément exactes. Cela est lié à la compression, la déduplication de données et au masquage des informations pour des raisons de sécurité.
Vous pourrez observer que quota
varie en fonction des origines. Cette variation est basée sur plusieurs facteurs dont :
- La fréquence de visite du site
- Les données publiques quant à la popularité du site
- Les signaux d'engagement fournis par la personne comme la mise en favori, l'inscription à l'écran d'accueil, ou l'acceptation des notifications push.
Exemples
Dans cet exemple, on récupère les estimations de l'espace utilisé et du quota total afin de présenter un pourcentage de l'espace actuellement occupé sur la page.
HTML
<label>
Vous utilisez actuellement <output id="percent"> </output>% du stockage
disponible.
</label>
JavaScript
navigator.storage.estimate().then(function (estimate) {
document.getElementById("percent").value = (
(estimate.usage / estimate.quota) *
100
).toFixed(2);
});
Résultat
Spécifications
Specification |
---|
Storage Standard # ref-for-dom-storagemanager-estimate |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- L'API Storage
Storage
, l'objet renvoyé parWindow.localStorage
StorageManager
navigator.storage