StorageManager: Methode estimate()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2023 browserübergreifend verfügbar.
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 Methode estimate() des Interfaces StorageManager fragt den Storage Manager, wie viel Speicherplatz der aktuelle Origin belegt (usage) und wie viel Speicherplatz verfügbar ist (quota).
Die Methode arbeitet asynchron und gibt daher ein Promise zurück, das erfüllt wird, sobald die Informationen verfügbar sind. Der Erfüllungshandler des Promise erhält ein Objekt mit den Daten zu Speicherbelegung und verfügbarem Speicherplatz.
Syntax
estimate()
Parameter
Keine.
Rückgabewert
Ein Promise, das mit einem Objekt erfüllt wird, das die folgenden Eigenschaften enthält:
quota-
Ein numerischer Wert in Byte, der den gesamten Speicherplatz, der auf dem Gerät oder Computer des Benutzers für den Origin der Website oder Web-App verfügbar ist, vorsichtig schätzt. Möglicherweise ist mehr Speicherplatz verfügbar; darauf können Sie sich jedoch nicht verlassen.
usage-
Ein numerischer Wert in Byte, der schätzt, wie viel des durch
quotaangegebenen verfügbaren Speicherplatzes die Website oder Web-App derzeit belegt. Die Einheit ist Byte. usageDetails-
Ein Objekt, das
usagenach Speichersystem aufschlüsselt. Alle enthaltenen Eigenschaften haben einenusage-Wert größer als 0. Speichersysteme mit einemusage-Wert von 0 sind nicht im Objekt enthalten.
Hinweis: Die zurückgegebenen Werte sind nicht exakt: Aufgrund von Komprimierung, Deduplizierung und Verschleierung aus Sicherheitsgründen sind sie ungenau.
Der Wert von quota kann sich von Origin zu Origin unterscheiden. Diese Unterschiede beruhen unter anderem auf folgenden Faktoren:
- Wie häufig der Benutzer die Website besucht
- Öffentliche Daten zur Beliebtheit der Website
- Hinweise auf die Interaktion des Benutzers mit der Website, etwa das Setzen eines Lesezeichens, das Hinzufügen zum Startbildschirm oder das Akzeptieren von Push-Benachrichtigungen
Ausnahmen
TypeError-
Wird ausgelöst, wenn der Zugriff auf den lokalen Speicherbereich fehlschlägt. Das kann beispielsweise der Fall sein, wenn der aktuelle Origin undurchsichtig ist oder der Benutzer die Speicherung deaktiviert hat.
Beispiele
In diesem Beispiel ermitteln wir die geschätzte Speicherbelegung und zeigen dem Benutzer an, wie viel Prozent des verfügbaren Speicherplatzes derzeit belegt sind.
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
| Spezifikation |
|---|
| Storage # dom-storagemanager-estimate |
Browser-Kompatibilität
Siehe auch
- Storage API
Storage, das vonWindow.localStoragezurückgegebene ObjektStorageManagernavigator.storage