Réprésente la zone de stockage de synchronisation. Les éléments stockés dans la  synchronisation sont synchronisés par le navigateur, et sont disponibles sur toutes les instances de ce navigateur auxquelles l'utilisateur est connecté (par exemple via la synchronisation Firefox ou un compte Google), sur différents appareils.

Pour Firefox, un utilisateur doit avoir des Add-ons vérifiés dans les options "Sync Settings" dans "about:preferences".

Notez que l'implémentation de storage.sync dans Firefox repose sur l'ID Add-on. ISi vous utilisez storage.sync, vous devez définir un ID pour votre extension à l'aide de la clé manifest.json des applications.

Le principal cas d'utilisation de cette API est de stocker les préférences concernant votre extension et de permettre à l'utilisateur de les synchroniser avec différents profils. Vous pouvez stocker jusqu'à 100 Ko de données à l'aide de cette API. Si vous essayez de stocker plus que cela, l'appel échouera avec un message d'erreur. L'API est fournie sans garantie de disponibilité ou de performance.

Méthodes

L'objet sync implémente les méthodes définies sur le type  storage.StorageArea :

storage.StorageArea.get()
Récupère un ou plusieurs éléments de la zone de stockage.
storage.StorageArea.getBytesInUse()
Obtient la quantité d'espace de stockage (en octets) utilisée pour stocker un ou plusieurs éléments dans la zone de stockage.
storage.StorageArea.set()
Stocke un ou plusieurs éléments dans la zone de stockage. Si un élément existe déjà, sa valeur sera mise à jour.
storage.StorageArea.remove()
Supprime un ou plusieurs éléments de la zone de stockage.
storage.StorageArea.clear()
Supprime tous les éléments de la zone de stockage.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui1553 Non Non

Example extensions

Remerciements :

Cette API est basée sur l'API Chromium chrome.storage. Cette documentation est dérivée de storage.json dans le code de Chromium.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,