StorageManager.estimate()
Baseline
2023
Newly available
Depuis September 2023, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
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. usageDetailsNon standard-
Un objet contenant une décomposition de
usagepar système de stockage. Toutes les propriétés incluses sur cet objet auront unusagesupé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 # dom-storagemanager-estimate |
Compatibilité des navigateurs
Chargement…
Voir aussi
- L'API Storage
Storage, l'objet renvoyé parWindow.localStorageStorageManagernavigator.storage