Storage API

Das Speichersystem, das durch den Storage Standard beschrieben wird, in dem Websitedaten gespeichert werden, besteht in der Regel aus einem einzigen Bucket für jeden Ursprung.

Im Wesentlichen hat jede Website ihren eigenen Speicherplatz, in den ihre Daten gelegt werden. In einigen Fällen können Benutzeragenten jedoch entscheiden, die Daten eines einzelnen Ursprungs in mehreren verschiedenen Buckets zu speichern, zum Beispiel wenn dieser Ursprung in verschiedenen Drittanbieter-Ursprüngen eingebettet ist.

Um mehr zu erfahren, siehe Wie trennen Browser Daten von verschiedenen Websites?

Jeder Site-Speicherbucket hat einen Modus, der die Datenaufbewahrungsrichtlinie für diesen Bucket beschreibt. Es gibt zwei Modi:

"best-effort"

Der Benutzeragent wird versuchen, die im Bucket enthaltenen Daten so lange wie möglich beizubehalten, wird die Benutzer jedoch nicht warnen, wenn der Speicher knapp wird und es notwendig wird, den Bucket zu leeren, um den Speicherplatzdruck zu verringern.

"persistent"

Der Benutzeragent wird die Daten so lange wie möglich aufbewahren und alle "best-effort"-Buckets leeren, bevor er in Betracht zieht, einen als "persistent" markierten Bucket zu leeren. Sollte es notwendig werden, persistente Buckets zu löschen, wird der Benutzeragent den Benutzer benachrichtigen und eine Möglichkeit bieten, einen oder mehrere persistente Buckets nach Bedarf zu löschen.

Sie können den Speicherbucket-Modus eines Ursprungs ändern, indem Sie die Methode navigator.storage.persist() verwenden, die die "persistent-storage" Nutzerberechtigung erfordert.

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.");
    }
  });
}

Sie können auch die Methode navigator.storage.persisted() verwenden, um zu erfahren, ob der Speicher eines Ursprungs persistent ist oder nicht:

if (navigator.storage && navigator.storage.persist) {
  navigator.storage.persisted().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.");
    }
  });
}

Um mehr zu erfahren, siehe Bleiben im Browser gespeicherte Daten bestehen?.

Der Benutzeragent bestimmt, mithilfe eines beliebigen Mechanismus, den er wählt, die maximale Menge an Speicher, die eine bestimmte Website verwenden kann. Dieses Maximum ist die Quote des Ursprungs. Die Menge dieses Platzes, die von der Website genutzt wird, wird als Nutzung bezeichnet. Beide Werte sind Schätzungen; es gibt mehrere Gründe, warum sie nicht genau sind:

• Benutzeragenten werden ermutigt, die genaue Größe der von einem bestimmten Ursprung verwendeten Daten zu verschleiern, um zu verhindern, dass diese Werte für Fingerprinting-Zwecke verwendet werden.
• Methoden wie Deduplizierung, Kompression und andere, die physische Größe der gespeicherten Daten zu reduzieren, können verwendet werden.
• Quoten sind konservative Schätzungen des Platzes, der dem Ursprung zur Verfügung steht, und sollten geringer sein als der verfügbare Platz auf dem Gerät, um Überlastungen zu verhindern.

Um die geschätzten Quoten- und Nutzungswerte für einen bestimmten Ursprung zu bestimmen, verwenden Sie die Methode navigator.storage.estimate(), die ein Promise zurückgibt, das, wenn es aufgelöst wird, ein Objekt erhält, das diese Zahlen enthält. Zum Beispiel:

navigator.storage.estimate().then((estimate) => {
  // estimate.quota is the estimated quota
  // estimate.usage is the estimated number of bytes used
});

Für weitere Informationen darüber, wie viel Daten ein Ursprung speichern kann, siehe Wie viele Daten können gespeichert werden?.

Datenlöschung ist der Prozess, durch den ein Benutzeragent die gespeicherten Daten eines Ursprungs löscht. Dies kann beispielsweise passieren, wenn das Gerät, das die Daten speichert, wenig Speicherplatz hat.

Beim Löschen der von einem Ursprung gespeicherten Daten wird der Bucket des Ursprungs als einzelne Einheit behandelt. Die gesamten von diesem Ursprung gespeicherten Daten werden gelöscht.

Wenn ein Bucket als "persistent" markiert ist, werden die Inhalte nicht vom Benutzeragenten gelöscht, ohne dass entweder der Ursprung der Daten selbst oder der Benutzer dies explizit tut. Dies schließt Szenarien wie die Auswahl der Optionen "Caches löschen" oder "Neuste Verlauf löschen" durch den Benutzer ein. Der Benutzer wird speziell um Erlaubnis gebeten, um persistente Speicherbuckets der Seite zu entfernen.

Um mehr zu erfahren, siehe Wann werden Daten gelöscht?.

StorageManager

Bietet eine Schnittstelle zur Verwaltung von Persistenzberechtigungen und zur Schätzung des verfügbaren Speichers.

Navigator.storage Nur lesbar

Gibt das Singleton StorageManager-Objekt zurück, das zur Verwaltung von Persistenzberechtigungen und zur Schätzung des verfügbaren Speichers auf Site-für-Site-/App-für-App-Basis verwendet wird.

WorkerNavigator.storage Nur lesbar

Gibt eine StorageManager-Schnittstelle zurück, um Persistenzberechtigungen zu verwalten und den verfügbaren Speicher zu schätzen.

• Verwendung der Permissions API
• Speicher im Web auf web.dev
• Persistenter Speicher auf web.dev
• Chrome Web Storage und Quota Konzepte