storage

Ermöglicht Erweiterungen das Speichern und Abrufen von Daten sowie das Lauschen auf Änderungen an gespeicherten Elementen.

Das Speichersystem basiert auf der Web Storage API mit einigen Unterschieden. Zu den Unterschieden gehören unter anderem:

• Es ist asynchron.
• Werte sind auf die Erweiterung beschränkt, nicht auf eine spezifische Domain (d.h. derselbe Satz von Schlüssel/Wert-Paaren ist in allen Skripten im Hintergrundkontext und in Inhalts-Skripten verfügbar).
• Die gespeicherten Werte können beliebige JSON-ifizierbare Werte sein, nicht nur String. Das schließt unter anderem Array und Object ein, aber nur, wenn deren Inhalte als JSON dargestellt werden können, was DOM-Knoten nicht umfasst. Sie müssen Ihre Werte nicht in JSON Strings umwandeln, bevor Sie sie speichern; sie werden jedoch intern als JSON dargestellt, was die Anforderung erklärt, dass sie JSON-ifizierbar sein müssen.
• Mehrere Schlüssel/Wert-Paare können in einem einzigen API-Aufruf gesetzt oder abgerufen werden.

Um diese API zu nutzen, müssen Sie die "storage" Berechtigung in Ihrer manifest.json Datei aufnehmen.

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

Obwohl diese API ähnlich wie Window.localStorage ist, wird empfohlen, Window.localStorage nicht im Erweiterungscode zu verwenden, um erweiterungsbezogene Daten zu speichern. Firefox wird Daten, die von Erweiterungen unter Verwendung der localStorage-API gespeichert werden, in verschiedenen Szenarien löschen, 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 beibehalten.

Sie können die gespeicherten Daten unter dem Element Erweiterungsspeicher im Speicherinspektor Tab des Entwicklerwerkzeugkastens untersuchen, zugänglich über about:debugging.