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 beim Storage Manager ab, wie viel Speicherplatz der aktuelle Origin belegt (usage) und wie viel Speicherplatz verfügbar ist (quota).
Diese Methode arbeitet asynchron und gibt daher ein Promise zurück, das erfüllt wird, sobald die Informationen verfügbar sind. Der Fulfillment-Handler des Promise wird mit einem Objekt aufgerufen, das die Angaben zu Speicherbelegung und verfügbarem Speicherplatz enthält.
Syntax
estimate()
Parameter
Keine.
Rückgabewert
Ein Promise, das mit einem Objekt mit den folgenden Eigenschaften erfüllt wird:
quota-
Ein numerischer Wert in Byte, der eine vorsichtige Schätzung des gesamten Speicherplatzes angibt, der auf dem Gerät oder Computer des Benutzers für den Origin der Website oder Web-App verfügbar ist. Möglicherweise steht mehr Speicherplatz zur Verfügung; 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: Durch Komprimierung, Deduplizierung und Verschleierung aus Sicherheitsgründen sind sie ungenau.
Hinweis:
In Firefox ist quota das von allen Origins derselben Website gemeinsam genutzte Limit, das sogenannte Gruppenlimit, und kein Limit für einen einzelnen Origin. Origins, denen persistenter Speicher über StorageManager.persist() gewährt wurde, unterliegen nicht dem Gruppenlimit. Für sie ist quota stattdessen das globale Speicherlimit. Wie diese Limits berechnet werden, erfahren Sie unter Speicherkontingente und Kriterien für die Verdrängung.
Der Wert von quota kann von Origin zu Origin variieren. Diese Unterschiede beruhen auf Faktoren wie:
- Wie häufig der Benutzer die Website besucht
- Öffentlich verfügbaren Daten zur Beliebtheit der Website
- Signalen für die Interaktion des Benutzers, etwa dem Setzen eines Lesezeichens, dem Hinzufügen zum Startbildschirm oder dem Akzeptieren von Push-Benachrichtigungen
Ausnahmen
TypeError-
Wird ausgelöst, wenn der Zugriff auf einen lokalen Speicherbereich fehlschlägt. Dies kann beispielsweise der Fall sein, wenn der aktuelle Origin ein opaker Origin ist oder der Benutzer die Speicherung deaktiviert hat.
Beispiele
In diesem Beispiel rufen wir Schätzwerte zur Speicherbelegung ab und zeigen dem Benutzer an, wie viel Prozent der Speicherkapazität derzeit genutzt werden.
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