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 beschränken, die eine Erweiterung im lokalen Speicherbereich speichern kann. Zum Beispiel:
- In Chrome ist eine Erweiterung darauf beschränkt, 5 MB Daten mit dieser API zu speichern, es sei denn, sie hat die
"unlimitedStorage"-Berechtigung. - In Firefox unterliegt die Menge der Daten, die eine Erweiterung speichern kann, denselben Speichergrenzen wie bei IndexedDB-Datenbanken. Erweiterungen, die beabsichtigen, mehr Daten als dieses Limit zu speichern, benötigen die "unlimitedStorage"-Berechtigung. Allerdings kann bei Erweiterungen mit der "unlimitedStorage"-Berechtigung ein Quota-Exceeded-Fehler auftreten, wenn der für die Speicherung verwendete Speicherplatz das globale Limit überschreitet.
Wenn die Erweiterung deinstalliert wird, wird ihr zugeordneter lokaler Speicher gelöscht.
Auch in Firefox können Sie verhindern, dass der Browser den lokalen Speicher bei der Deinstallation löscht, indem Sie about:config aufrufen und diese Browser-Einstellungen auf true setzen: "keepUuidOnUninstall" und "keepStorageOnUninstall". Diese Funktion soll Entwicklern helfen, ihre Erweiterungen zu testen. Die Erweiterungen selbst können diese Einstellungen nicht ändern.
Obwohl diese API der Window.localStorage ähnelt, wird empfohlen, Window.localStorage nicht im Erweiterungscode zu verwenden. Firefox löscht Daten, die von Erweiterungen mit der localStorage-API gespeichert wurden, in verschiedenen Situationen, 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 storage.StorageArea-Typ definierten Methoden:
storage.local.get()-
Ruft ein oder mehrere Elemente aus dem Speicherbereich ab.
storage.local.getBytesInUse()-
Ruft die Menge des Speicherplatzes (in Bytes) ab, der für ein oder mehrere Elemente im Speicherbereich verwendet wird.
storage.local.getKeys()-
Ruft die Schlüssel aller Elemente im Speicherbereich ab.
storage.local.set()-
Speichert ein oder mehrere Elemente im Speicherbereich. Falls 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 storage.StorageArea-Typ definierten Ereignisse:
storage.local.onChanged-
Wird ausgelöst, wenn ein oder mehrere Elemente im Speicherbereich geändert werden.
Beispielerweiterungen
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf Chromiums chrome.storage API. Diese Dokumentation stammt aus storage.json im Chromium-Code.