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 der Daten einschränken, die eine Erweiterung im lokalen Speicherbereich speichern kann. Zum Beispiel:
- In Chrome ist eine Erweiterung auf das Speichern von 5MB Daten mit dieser API beschränkt, 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 können Erweiterungen mit der "unlimitedStorage" Berechtigung einen Quota-Exceeded-Fehler erhalten, wenn der durch den Speicher genutzte Speicherplatz das globale Limit überschreitet.
Wenn die Erweiterung deinstalliert wird, wird der zugehörige lokale Speicher gelöscht.
Außerdem können Sie in Firefox verhindern, dass der Browser den lokalen Speicher bei der Deinstallation löscht, indem Sie about:config aufrufen und diese Browsereinstellungen auf true setzen: "keepUuidOnUninstall" und "keepStorageOnUninstall". Diese Funktionalität wird bereitgestellt, um Entwicklern zu helfen, ihre Erweiterungen zu testen. 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 über die localStorage-API gespeichert werden, 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, werden in diesen Szenarien korrekt gespeichert.
Methoden
Das local Objekt implementiert die Methoden, die im storage.StorageArea Typ definiert sind:
storage.local.get()-
Ruft ein oder mehrere Elemente aus dem Speicherbereich ab.
storage.local.getBytesInUse()-
Ermittelt die Speichermenge (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 dessen 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 Ereignisse, die im storage.StorageArea Typ definiert sind:
storage.local.onChanged-
Wird ausgelöst, wenn sich ein oder mehrere Elemente im Speicherbereich ändern.
Beispiel-Erweiterungen
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis: Diese API basiert auf Chromium's chrome.storage API. Diese Dokumentation ist abgeleitet von storage.json im Chromium-Code.