Ermöglicht es Erweiterungen, Daten zu speichern und abzurufen sowie Änderungen an gespeicherten Elementen zu überwachen.
Das Speichersystem basiert auf der Web Storage API, weist jedoch einige Unterschiede auf. Unter anderem:
Es ist asynchron.
Werte sind auf die Erweiterung beschränkt, nicht auf eine spezifische Domäne (d. h. dasselbe Set von Schlüssel/Wert-Paaren ist für alle Skripte im Hintergrundkontext und in Inhalts-Skripten verfügbar).
Die gespeicherten Werte können beliebige JSON-fähige Werte sein, nicht nur String. Dazu gehören unter anderem: Array und Object, aber nur, wenn deren Inhalte als JSON darstellbar sind, was DOM-Knoten nicht einschließt. Sie müssen Ihre Werte nicht in JSON Strings umwandeln, bevor Sie sie speichern, aber intern werden sie als JSON dargestellt, daher die Anforderung, dass sie JSON-fähig sein müssen.
Mehrere Schlüssel/Wert-Paare können in demselben API-Aufruf gesetzt oder abgerufen werden.
Um diese API zu verwenden, müssen Sie die Berechtigung "storage" in Ihrer manifest.json Datei einfügen.
Jede Erweiterung verfügt über ihren eigenen Speicherbereich, der in verschiedene Speicherarten aufgeteilt werden kann.
Obwohl diese API ähnlich wie Window.localStorage ist, wird empfohlen, Window.localStorage nicht im Erweiterungscode zum Speichern von erweiterungsbezogenen Daten 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, während Daten, die mit der storage.local API gespeichert wurden, in diesen Szenarien korrekt erhalten bleiben.
Sie können die gespeicherten Daten unter dem Element Erweiterungsspeicher im Storage Inspector-Tab der Entwicklertools untersuchen, erreichbar über about:debugging.
Hinweis:
Der Speicherbereich ist nicht verschlüsselt und sollte nicht zum Speichern vertraulicher Benutzerinformationen verwendet werden.
Repräsentiert den managed Speicherbereich. Elemente im managed Speicher werden vom Domänenadministrator festgelegt und sind für die Erweiterung schreibgeschützt. Der Versuch, diesen Namensraum zu ändern, führt zu einem Fehler.
Repräsentiert den sync Speicherbereich. Elemente im sync Speicher werden vom Browser synchronisiert und sind über alle Instanzen dieses Browsers, bei denen der Benutzer angemeldet ist, auf unterschiedlichen Geräten verfügbar.
Tip: you can click/tap on a cell for more information.
Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.