storage.local

Repräsentiert den local-Speicherbereich. Elemente im local-Speicher sind lokal auf dem Rechner, auf dem die Erweiterung installiert ist.

Der Browser kann die Menge an Daten beschränken, die eine Erweiterung im lokalen Speicherbereich speichern kann. Zum Beispiel:

  • In Chrome ist eine Erweiterung auf das Speichern von 5 MB Daten mit dieser API beschränkt, es sei denn, sie hat die Berechtigung "unlimitedStorage".
  • In Firefox unterliegt die Datenmenge, die eine Erweiterung speichern kann, denselben Speicherbeschränkungen wie bei IndexedDB-Datenbanken. Erweiterungen, die beabsichtigen, mehr Daten als dieses Limit zu speichern, benötigen die Berechtigung "unlimitedStorage". Erweiterungen mit der "unlimitedStorage"-Berechtigung können jedoch einen Quota exceeded error erhalten, wenn der durch den Speicher genutzte Speicherplatz das globale Limit überschreitet.

Wenn die Erweiterung deinstalliert wird, wird ihr zugehöriger lokal gespeicherter Speicher gelöscht.

Auch in Firefox können Sie verhindern, dass der Browser den lokalen Speicher beim Deinstallieren löscht, indem Sie about:config besuchen und diese Browsereinstellungen auf true setzen: "keepUuidOnUninstall" und "keepStorageOnUninstall". Diese Funktion wird bereitgestellt, um Entwicklern bei der Testung ihrer Erweiterungen zu helfen. Erweiterungen selbst können diese Voreinstellungen nicht ändern.

Obwohl diese API der Window.localStorage ähnlich ist, wird empfohlen, Window.localStorage im Erweiterungscode nicht zu verwenden. Firefox löscht Daten, die von Erweiterungen mit der localStorage-API gespeichert wurden, in verschiedenen Szenarien, in denen Benutzer ihren Browserverlauf und ihre Daten aus Datenschutzgründen löschen. Daten, die mit der storage.local-API gespeichert werden, bleiben in diesen Szenarien korrekt erhalten.

Methoden

Das local-Objekt implementiert die auf dem Typ storage.StorageArea definierten Methoden:

storage.local.get()

Ruft ein oder mehrere Elemente aus dem Speicherbereich ab.

storage.local.getBytesInUse()

Ermittelt die Menge des Speicherplatzes (in Bytes), die für ein oder mehrere Elemente im Speicherbereich verwendet wird.

storage.local.set()

Speichert ein oder mehrere Elemente im Speicherbereich. Wenn das Element existiert, wird sein Wert aktualisiert.

storage.local.remove()

Entfernt ein oder mehrere Elemente aus dem Speicherbereich.

storage.local.clear()

Entfernt alle Elemente aus dem Speicherbereich.

Ereignisse

Das local-Objekt implementiert die auf dem Typ storage.StorageArea definierten Ereignisse:

storage.local.onChanged

Wird ausgelöst, wenn sich ein oder mehrere Elemente im Speicherbereich ändern.

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.storage API von Chromium. Diese Dokumentation ist aus storage.json im Chromium-Code abgeleitet.