storage.sync

Der Browser erzwingt Grenzen für die Menge an Daten, die jede Erweiterung im Synchronisierungsspeicherbereich speichern darf:

Wenn eine Erweiterung versucht, Elemente zu speichern, die diese Grenzen überschreiten, werden Aufrufe an storage.sync.set() mit einem Fehler abgelehnt. Eine Erweiterung kann storage.sync.getBytesInUse() verwenden, um herauszufinden, wie viel ihres Kontingents verwendet wird.

In Firefox werden Erweiterungsdaten alle 10 Minuten synchronisiert oder wann immer der Benutzer Jetzt synchronisieren auswählt (in Einstellungen > Sync oder über das Mozilla-Kontosymbol). Wenn der Browser eine Synchronisierung durchführt, vergleicht er für jeden gespeicherten Schlüssel den Wert auf dem Server mit dem Wert bei der letzten Synchronisierung. Wenn sie unterschiedlich sind, wird der Wert vom Server auf den Schlüssel im Synchronisierungsspeicher des Browsers geschrieben. Der Browser vergleicht auch die Werte des Synchronisierungsspeichers mit dem Wert auf dem Server; wenn sie unterschiedlich sind, schreibt er den Schlüsselwert des Browsers auf den Server.

Dies bedeutet, dass bei jedem Schlüssel eine Änderung auf dem Server Vorrang vor einer Änderung im Synchronisierungsspeicher des Browsers hat.

Dieser Mechanismus ist im Allgemeinen für Daten wie Benutzereinstellungen oder andere globale Einstellungen, die vom Benutzer geändert werden, in Ordnung.

Es kann jedoch vorkommen, dass der Wert eines Schlüssels in einem Browser aktualisiert und synchronisiert wird und dann in einem zweiten Browser aktualisiert wird, bevor der zweite Browser synchronisiert wird, was dazu führt, dass das lokale Update während der Synchronisierung überschrieben wird. Dieser Mechanismus ist daher nicht ideal für Daten, die über mehrere Geräte aggregiert werden, wie eine Zählung der Seitenaufrufe oder wie oft eine Option verwendet wird. Um solche Fälle zu behandeln, verwenden Sie storage.sync.onChanged, um auf Synchronisierungsaktualisierungen vom Server (wie z.B. eine Zählung der Seitenaufrufe auf einer anderen Browserinstanz) zu hören. Dann passen Sie den Wert lokal an, um den Remote-Wert zu berücksichtigen (z.B. aktualisieren Sie die Gesamtansichten basierend auf der entfernten Zählung und der neuen lokalen Zählung).

Das sync-Objekt implementiert die auf dem storage.StorageArea Typ definierten Methoden:

storage.sync.get()

Ruft ein oder mehrere Elemente aus dem Speicherbereich ab.

storage.sync.getBytesInUse()

Ermittelt den Speicherplatz (in Bytes), der für ein oder mehrere Elemente im Speicherbereich verwendet wird.

storage.sync.set()

Speichert ein oder mehrere Elemente im Speicherbereich. Existiert das Element bereits, wird sein Wert aktualisiert.

storage.sync.remove()

Entfernt ein oder mehrere Elemente aus dem Speicherbereich.

storage.sync.clear()

Entfernt alle Elemente aus dem Speicherbereich.

Das sync-Objekt implementiert die auf dem storage.StorageArea Typ definierten Ereignisse:

storage.sync.onChanged

Wird ausgelöst, wenn sich ein oder mehrere Elemente im Speicherbereich ändern.

• favourite-colour