StorageManager: Methode persist()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Dezember 2021 browserübergreifend verfügbar.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die Methode persist() der StorageManager-Schnittstelle fordert die Berechtigung zur Nutzung dauerhaften Speichers an und gibt ein Promise zurück, das zu true aufgelöst wird, wenn die Berechtigung erteilt wurde und der Bucket-Modus dauerhaft ist, andernfalls zu false. Ob der Browser der Anfrage entspricht, hängt von browserspezifischen Regeln ab. (Weitere Einzelheiten finden Sie im Leitfaden zu Speicherkontingenten und Kriterien für die Datenentfernung.)
Hinweis:
Diese Methode ist in Web Workers nicht verfügbar, die StorageManager-Schnittstelle hingegen schon.
Syntax
persist()
Parameter
Keine.
Rückgabewert
Ausnahmen
TypeError-
Wird ausgelöst, wenn kein lokaler Speicherbereich abgerufen werden konnte. Dies kann beispielsweise der Fall sein, wenn der aktuelle Ursprung ein opaker Ursprung ist oder der Benutzer die Speicherung deaktiviert hat.
Beispiel
if (navigator.storage && navigator.storage.persist) {
navigator.storage.persist().then((persistent) => {
if (persistent) {
console.log("Storage will not be cleared except by explicit user action");
} else {
console.log("Storage may be cleared by the UA under storage pressure.");
}
});
}
Spezifikationen
| Spezifikation |
|---|
| Storage # dom-storagemanager-persist |