StorageArea

L'interfaccia StorageArea viene utilizzata dall'API browser.storage.

Metodi

clear()

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

Rimuove tutti gli elementi dallo spazio di archiviazione.

Resi

  • Promise<void>

    Browser Chrome 95+ .* da Chrome 148

    Promise che si risolve in caso di esito positivo o viene rifiutata in caso di errore.

get()

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

Recupera uno o più elementi dallo spazio di archiviazione.

Parametri

  • chiavi

    string | string[] | object facoltativo

    Una singola chiave da recuperare, un elenco di chiavi da recuperare o un dizionario che specifica i valori predefiniti (vedi la descrizione dell'oggetto). Un elenco o un oggetto vuoto restituirà un oggetto risultato vuoto. Passa null per ottenere l'intero contenuto dello spazio di archiviazione.

Resi

  • Promise<object>

    Browser Chrome 95+ .* da Chrome 148

    Promise che si risolve con un oggetto contenente una mappa chiave-valore per gli elementi richiesti o che viene rifiutata in caso di errore.

getBytesInUse()

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

Recupera la quantità di spazio (in byte) utilizzata da uno o più elementi.

Parametri

  • chiavi

    string | string[] facoltativo

    Una singola chiave o un elenco di chiavi per cui ottenere l'utilizzo totale. Un elenco vuoto restituirà 0. Passa null per ottenere l'utilizzo totale di tutto lo spazio di archiviazione.

Resi

  • Promise<number>

    Browser Chrome 95+ .* da Chrome 148

    Promise che si risolve con la quantità di spazio utilizzata dallo spazio di archiviazione o che viene rifiutata in caso di errore.

getKeys()

Chrome 130 e versioni successive browser.* da Chrome 148 
browser.storage.StorageArea.getKeys(): Promise<string[]>

Recupera tutte le chiavi dallo spazio di archiviazione.

Resi

  • Promise<string[]>

    Promise che si risolve con le chiavi di archiviazione o viene rifiutata in caso di errore.

remove()

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

Rimuove uno o più elementi dallo spazio di archiviazione.

Parametri

  • chiavi

    string | string[]

    Una singola chiave o un elenco di chiavi per gli elementi da rimuovere.

Resi

  • Promise<void>

    Browser Chrome 95+ .* da Chrome 148

    Promise che si risolve in caso di esito positivo o viene rifiutata in caso di errore.

set()

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

Imposta più elementi.

Parametri

  • elementi

    oggetto

    Un oggetto che fornisce ogni coppia chiave/valore con cui aggiornare lo spazio di archiviazione. Le altre coppie chiave-valore nello spazio di archiviazione non saranno interessate.

    I valori primitivi, come i numeri, verranno serializzati come previsto. I valori con typeof "object" e "function" in genere vengono serializzati in {}, ad eccezione di Array (serializzato come previsto), Date e Regex (serializzati utilizzando la relativa rappresentazione String).

Resi

  • Promise<void>

    Browser Chrome 95+ .* da Chrome 148

    Promise che si risolve in caso di esito positivo o viene rifiutata in caso di errore.

setAccessLevel()

Browser Chrome 102 e versioni successive.* A partire da Chrome 148 
browser.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): Promise<void>

Imposta il livello di accesso desiderato per l'area di archiviazione. Per impostazione predefinita, lo spazio di archiviazione session è limitato ai contesti attendibili (pagine di estensione e service worker), mentre lo spazio di archiviazione managed, local e sync consente l'accesso sia da contesti attendibili che non attendibili.

Parametri

  • accessOptions

    oggetto

    • accessLevel

      AccessLevel

      Il livello di accesso dell'area di archiviazione.

Resi

  • Promise<void>

    Promise che si risolve in caso di esito positivo o viene rifiutata in caso di errore.

Eventi

onChanged

Chrome 73 e versioni successive browser.* da Chrome 148 
browser.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Attivato quando uno o più elementi cambiano.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (changes: object) => void

    • modifiche

      oggetto