StorageManager: persist() Methode

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die persist()-Methode der StorageManager-Schnittstelle fordert die Erlaubnis an, persistenten Speicher zu verwenden, und gibt ein Promise zurück, das sich auf true auflöst, wenn die Erlaubnis erteilt und der Bucket-Modus persistent ist, und auf false sonst. Der Browser könnte die Anfrage je nach browser-spezifischen Regeln berücksichtigen oder nicht. (Für weitere Details siehe den Leitfaden zu Speicherquoten und Löschkriterien.)

Hinweis: Diese Methode ist nicht in Web Workers verfügbar, obwohl die StorageManager-Schnittstelle es ist.

Syntax

js
persist()

Parameter

Keine.

Rückgabewert

Ein Promise, das sich auf einen Boolean auflöst.

Ausnahmen

TypeError

Wird ausgelöst, wenn das Erhalten eines lokalen Speicherung-Regals fehlschlägt. Zum Beispiel, wenn der aktuelle Ursprung ein opaker Ursprung ist oder wenn der Benutzer den Speicher deaktiviert hat.

Beispiel

js
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

Specification
Storage Standard
# ref-for-dom-storagemanager-persist

Browser-Kompatibilität

BCD tables only load in the browser