chrome.system.storage

refresh date: 2026-09-25 robots: noindex

Descrizione

Utilizza l'API chrome.system.storage per eseguire query sulle informazioni del dispositivo di archiviazione e ricevere una notifica quando un dispositivo di archiviazione rimovibile viene collegato e scollegato.

Autorizzazioni

system.storage

Tipi

EjectDeviceResultCode

Enum

"success"
Il comando di espulsione è andato a buon fine. L'applicazione può chiedere all'utente di rimuovere il dispositivo.

"in_use"
Il dispositivo è in uso da un'altra applicazione. L'espulsione non è riuscita; l'utente non deve rimuovere il dispositivo finché l'altra applicazione non ha terminato di utilizzarlo.

"no_such_device"
Non è noto alcun dispositivo di questo tipo.

"failure"
Il comando di espulsione non è riuscito.

StorageAvailableCapacityInfo

Proprietà

  • availableCapacity

    numero

    La capacità disponibile del dispositivo di archiviazione, in byte.

  • id

    stringa

    Un id copiato del parametro della funzione getAvailableCapacity id.

StorageUnitInfo

Proprietà

  • capacità

    numero

    La quantità totale di spazio di archiviazione, in byte.

  • id

    stringa

    L'ID temporaneo che identifica in modo univoco il dispositivo di archiviazione. Questo ID rimarrà invariato nella stessa esecuzione di una singola applicazione. Non sarà un identificatore persistente tra diverse esecuzioni di un'applicazione o tra diverse applicazioni.

  • nome

    stringa

    Il nome dell'unità di archiviazione.

  • Il tipo di supporto dell'unità di archiviazione.

StorageUnitType

Enum

"fixed"
Lo spazio di archiviazione ha un supporto fisso, ad esempio un disco rigido o un'unità SSD.

"removable"
Lo spazio di archiviazione è rimovibile, ad esempio un'unità flash USB.

"unknown"
Il tipo di archiviazione è sconosciuto.

Metodi

ejectDevice()

Promise 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
): Promise<EjectDeviceResultCode>

Espelle un dispositivo di archiviazione rimovibile.

Parametri

Resi

  • Chrome 91 e versioni successive

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

getAvailableCapacity()

Promessa Canale Dev 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

Recupera la capacità disponibile di un dispositivo di archiviazione id specificato. id è l'ID dispositivo temporaneo di StorageUnitInfo.

Parametri

Resi

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

getInfo()

Promise 
chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

Recupera le informazioni sullo spazio di archiviazione dal sistema. L'argomento passato al callback è un array di oggetti StorageUnitInfo.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (info: StorageUnitInfo[]) => void

Resi

  • Promise<StorageUnitInfo[]>

    Chrome 91 e versioni successive

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

Eventi

onAttached

chrome.system.storage.onAttached.addListener(
  callback: function,
)

Attivato quando un nuovo spazio di archiviazione rimovibile viene collegato al sistema.

Parametri

onDetached

chrome.system.storage.onDetached.addListener(
  callback: function,
)

Attivato quando un dispositivo di archiviazione rimovibile viene scollegato dal sistema.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (id: string) => void

    • id

      stringa