StorageManager.estimate()
Baseline 2023
Newly available
Since September 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Contexto seguro: Esta función está disponible solo en contextos seguros (HTTPS), en algunos o todos los navegadores que lo soportan.
El método estimate()
de la interfaz StorageManager
solicita al Gestor de Almacenamiento la información de cuota y uso para el origen actual. Este método opera de forma asíncrona, por lo que devuelve una Promise
que se resuelve una vez que la información esté disponible. La función que controla el cumplimiento de la promesa recibe un StorageEstimate
como entrada con la informción de uso y cuota.
Sintaxis
var estimatePromise = StorageManager.estimate();
Parámetros
Ninguno.
Valor devuelto
Una Promise
que se resuelve como un objeto que se ajusta al diccionario StorageEstimate
. Este diccionario contiene estimaciones sobre la cantidad de espacio disponible para el origen o aplicación (en StorageEstimate.quota
, así como la cantidad que se usa en ese momento (in StorageEstimate.usage
). Estos no son números exactos; entre la compresión, la deduplicación y la ofuscación por razones de seguridad, no serán precisos.
Es posible que la quota
varíe de una aplicación a otra en función de factores como la frecuencia con la que el usuario la visita, los datos de popularidad del sitio, etc.
Ejemplo
En este ejemplo, obtenemos las estimaciones de uso y presentamos el porcentaje de la capacidad de almacenamiento utilizada actualmente al usuario.
HTML
<p>
You're currently using about <span id="percent"> </span>% of your available
storage.
</p>
JavaScript
navigator.storage.estimate().then(function (estimate) {
document.getElementById("percent").innerHTML = (
estimate.usage / estimate.quota
).toFixed(2);
});
Resultado
Especificaciones
Specification |
---|
Storage Standard # ref-for-dom-storagemanager-estimate |
Compatibilidad con navegadores
BCD tables only load in the browser
Ver también
- Storage API
Storage
, el objeto devuelto porWindow.localStorage
StorageManager
navigator.storage