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, mit einigen Unterschieden. Zu diesen Unterschieden gehören unter anderem:

• Es ist asynchron.
• Werte sind auf die Erweiterung begrenzt und nicht auf eine bestimmte Domain (d.h. dasselbe Set von Schlüssel-/Werte-Paaren ist für alle Skripte im Hintergrundkontext und in Inhaltsskripten verfügbar).
• Die gespeicherten Werte können beliebige JSON-konvertierbare Werte sein, nicht nur String. Dazu gehören unter anderem: Array und Object, jedoch nur, wenn deren Inhalte als JSON dargestellt werden können, was keine DOM-Knoten umfasst. Sie müssen Ihre Werte vor der Speicherung nicht in JSON-Strings umwandeln, aber sie werden intern als JSON dargestellt, weshalb sie JSON-konvertierbar sein müssen.
• Mehrere Schlüssel-/Werte-Paare können in einem einzigen API-Aufruf gesetzt oder abgerufen werden.

Um diese API zu verwenden, müssen Sie die "storage"-Berechtigung in Ihrer manifest.json-Datei einfügen.

Jede Erweiterung hat ihren eigenen Speicherbereich, der in verschiedene Speicherarten aufgeteilt werden kann.

Obwohl diese API Window.localStorage ähnelt, wird empfohlen, Window.localStorage im Erweiterungscode nicht zu verwenden, um erweiterungsbezogene Daten zu speichern. 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 werden, in diesen Szenarien korrekt erhalten bleiben.

Sie können die gespeicherten Daten unter dem Punkt "Extension Storage" im Storage Inspector im Entwicklerwerkzeugkasten einsehen, der über about:debugging zugänglich ist.