StorageManager: estimate() Methode
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.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die estimate()-Methode des StorageManager-Interfaces fragt den Storage Manager, wie viel Speicher der aktuelle Origin beansprucht (usage) und wie viel Speicherplatz verfügbar ist (quota).
Diese Methode arbeitet asynchron und gibt daher ein Promise zurück, das aufgelöst wird, sobald die Informationen verfügbar sind. Der Erfüllungs-Handler des Promises wird mit einem Objekt aufgerufen, das die Nutzungs- und Quotendaten enthält.
Syntax
estimate()
Parameter
Keine.
Rückgabewert
Ein Promise das zu einem Objekt mit den folgenden Eigenschaften aufgelöst wird:
quota-
Ein numerischer Wert in Bytes, der eine konservative Schätzung des gesamten Speichers angibt, der auf dem Gerät oder Computer des Nutzers für den Site-Origin oder die Web-App verfügbar ist. Es ist möglich, dass mehr Speicher verfügbar ist, jedoch sollte man sich darauf nicht verlassen.
usage-
Ein numerischer Wert in Bytes, der die Menge des derzeit von der Site oder Web-App genutzten Speicherplatzes aus dem verfügbaren Speicher, wie durch
quotaangegeben, annähert. Einheit ist Byte. usageDetailsNicht standardisiert-
Ein Objekt, das eine Aufschlüsselung der
usagenach Speichersystemen enthält. Alle enthaltenen Eigenschaften haben eineusagegrößer als 0 und jedes Speichersystem mit 0usagewird aus dem Objekt ausgeschlossen.
Hinweis: Die zurückgegebenen Werte sind nicht exakt: Aufgrund von Komprimierung, Deduplizierung und Verschleierung aus Sicherheitsgründen sind sie ungenau.
Es kann sein, dass das quota je nach Origin variiert. Diese Abweichung basiert auf Faktoren wie:
- Wie häufig der Nutzer die Seite besucht
- Öffentliche Popularitätsdaten der Seite
- Nutzerengagement-Signale wie das Setzen eines Lesezeichens, das Hinzufügen zum Startbildschirm oder das Akzeptieren von Push-Benachrichtigungen
Ausnahmen
TypeError-
Wird ausgelöst, wenn das Erlangen eines Lokalspeicherregals fehlschlug. Zum Beispiel, wenn der aktuelle Origin ein undurchsichtiger Origin ist oder wenn der Nutzer den Speicher deaktiviert hat.
Beispiele
In diesem Beispiel rufen wir die Speicherplatzschätzungen ab und präsentieren dem Nutzer den prozentualen Anteil der derzeit genutzten Speicherkapazität.
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`;
});
Ergebnis
Spezifikationen
| Specification |
|---|
| Storage # dom-storagemanager-estimate |
Browser-Kompatibilität
Siehe auch
- Storage API
Storage, das Objekt, das vonWindow.localStoragezurückgegeben wirdStorageManagernavigator.storage