storage

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.