StorageArea

L'interface StorageArea est utilisée par l'API chrome.storage.

Méthodes

clear()

chrome.storage.StorageArea.clear(): Promise<void>

Supprime tous les éléments du stockage.

Renvoie

  • Promise<void>

    Chrome 95 et versions ultérieures

get()

chrome.storage.StorageArea.get(
  keys?: string | string[] | object,
): Promise<object>

Récupère un ou plusieurs éléments du stockage.

Paramètres

  • clés

    string | string[] | object facultatif

    Clé unique à obtenir, liste de clés à obtenir ou dictionnaire spécifiant les valeurs par défaut (voir la description de l'objet). Une liste ou un objet vides renverront un objet de résultat vide. Transmettez null pour obtenir l'intégralité du contenu du stockage.

Renvoie

  • Promise<object>

    Chrome 95 et versions ultérieures

getBytesInUse()

chrome.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
): Promise<number>

Obtient la quantité d'espace (en octets) utilisée par un ou plusieurs éléments.

Paramètres

  • clés

    string | string[] facultatif

    Clé unique ou liste de clés pour lesquelles obtenir l'utilisation totale. Une liste vide renvoie la valeur 0. Transmettez null pour obtenir l'utilisation totale de l'espace de stockage.

Renvoie

  • Promise<number>

    Chrome 95 et versions ultérieures

getKeys()

Chrome 130 et versions ultérieures 
chrome.storage.StorageArea.getKeys(): Promise<string[]>

Obtient toutes les clés du stockage.

Renvoie

  • Promise<string[]>

remove()

chrome.storage.StorageArea.remove(
  keys: string | string[],
): Promise<void>

Supprime un ou plusieurs éléments du stockage.

Paramètres

  • clés

    chaîne | chaîne[]

    Clé unique ou liste de clés des éléments à supprimer.

Renvoie

  • Promise<void>

    Chrome 95 et versions ultérieures

set()

chrome.storage.StorageArea.set(
  items: object,
): Promise<void>

Définit plusieurs éléments.

Paramètres

  • éléments

    objet

    Objet qui fournit chaque paire clé/valeur pour mettre à jour le stockage. Les autres paires clé/valeur dans le stockage ne seront pas affectées.

    Les valeurs primitives telles que les nombres seront sérialisées comme prévu. Les valeurs avec typeof, "object" et "function" sont généralement sérialisées en {}, à l'exception de Array (sérialisé comme prévu), Date et Regex (sérialisés à l'aide de leur représentation String).

Renvoie

  • Promise<void>

    Chrome 95 et versions ultérieures

setAccessLevel()

Chrome 102 et versions ultérieures 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): Promise<void>

Définit le niveau d'accès souhaité pour la zone de stockage. Par défaut, le stockage session est limité aux contextes approuvés (pages d'extension et service workers), tandis que le stockage managed, local et sync autorise l'accès à partir de contextes approuvés et non approuvés.

Paramètres

  • accessOptions

    objet

    • accessLevel

      AccessLevel

      Niveau d'accès à l'espace de stockage.

Renvoie

  • Promise<void>

Événements

onChanged

Chrome 73 et versions ultérieures 
chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Déclenché lorsqu'un ou plusieurs éléments changent.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (changes: object) => void

    • modifications

      objet