storage.local

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

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

  • In Chrome ist eine Erweiterung darauf beschränkt, 5MB an Daten mit dieser API zu speichern, es sei denn, sie hat die Berechtigung "unlimitedStorage".
  • In Firefox unterliegt die Menge der Daten, die eine Erweiterung speichern kann, den gleichen Speicherbeschränkungen wie bei IndexedDB-Datenbanken. Erweiterungen, die mehr Daten speichern möchten als dieses Limit, benötigen die Berechtigung "unlimitedStorage". Erweiterungen mit der "unlimitedStorage"-Berechtigung können jedoch einen Quota-Exceeded-Fehler erhalten, wenn der von Speicher genutzte Speicherplatz das globale Limit überschreitet.

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

Auch in Firefox können Sie verhindern, dass der Browser den lokalen Speicher bei Deinstallation löscht, indem Sie about:config aufrufen und diese Browsereinstellungen auf true setzen: "keepUuidOnUninstall" und "keepStorageOnUninstall". Diese Funktion hilft Entwicklern, ihre Erweiterungen zu testen. Die Erweiterungen selbst können diese Einstellungen nicht ändern.

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

Methoden

Das Objekt local implementiert die Methoden, die auf dem Typ storage.StorageArea definiert sind:

storage.local.get()

Ruft ein oder mehrere Elemente aus dem Speicherbereich ab.

storage.local.getBytesInUse()

Ermittelt den Speicherplatz (in Bytes), der 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 Objekt local implementiert die Ereignisse, die auf dem Typ storage.StorageArea definiert sind:

storage.local.onChanged

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

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.storage API. Diese Dokumentation stammt aus storage.json im Chromium-Code.