StorageArea

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

Metodi

clear()

Promessa 
chrome.storage.StorageArea.clear(
  callback?: function,
): Promise<void>

Rimuove tutti gli elementi dallo spazio di archiviazione.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 95+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

get()

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

Recupera uno o più elementi dallo spazio di archiviazione.

Parametri

  • chiavi

    stringa | stringa[] | oggetto facoltativo

    Una singola chiave da ottenere, un elenco di chiavi da ottenere 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 a null per ottenere tutti i contenuti dello spazio di archiviazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (items: object) => void

    • elementi

      oggetto

      Oggetto con elementi nelle mappature di coppie chiave-valore.

Resi

  • Promise<object>

    Chrome 95+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getBytesInUse()

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

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

Parametri

  • chiavi

    stringa | stringa[] facoltativo

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (bytesInUse: number) => void

    • bytesInUse

      numero

      Quantità di spazio utilizzato nello spazio di archiviazione, in byte.

Resi

  • Promise<number>

    Chrome 95+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getKeys()

Promise Chrome 130+ 
chrome.storage.StorageArea.getKeys(
  callback?: function,
): Promise<string[]>

Recupera tutte le chiavi dallo spazio di archiviazione.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (keys: string[]) => void

    • chiavi

      string[]

      Array con chiavi lette dallo spazio di archiviazione.

Resi

  • Promise<string[]>

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

remove()

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

Rimuove uno o più elementi dallo spazio di archiviazione.

Parametri

  • chiavi

    stringa | stringa[]

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 95+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

set()

Promessa 
chrome.storage.StorageArea.set(
  items: object,
  callback?: function,
): Promise<void>

Imposta più elementi.

Parametri

  • elementi

    oggetto

    Un oggetto che fornisce ogni coppia chiave/valore per aggiornare l'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" vengono in genere serializzati in {}, ad eccezione di Array (serializzato come previsto), Date e Regex (serializzati utilizzando la rappresentazione String).

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 95+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

setAccessLevel()

Promise Chrome 102+ 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): 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 estensioni e service worker), mentre lo spazio di archiviazione managed, local e sync consente l'accesso da contesti attendibili e non attendibili.

Parametri

  • accessOptions

    oggetto

    • accessLevel

      AccessLevel

      Il livello di accesso dell'area di archiviazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

Eventi

onChanged

Chrome 73+ 
chrome.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