chrome.system.storage

Descrição

Use a API chrome.system.storage para consultar informações do dispositivo de armazenamento e receber notificações quando um dispositivo de armazenamento removível é conectado e desconectado.

Permissões

system.storage

Tipos

EjectDeviceResultCode

Enumeração

"success"
O comando de remoção foi concluído. O aplicativo pode pedir ao usuário para remover o dispositivo.

"in_use"
O dispositivo está sendo usado por outro aplicativo. A remoção não foi concluída. O usuário não deve remover o dispositivo até que o outro aplicativo termine de usá-lo.

"no_such_device"
Não há um dispositivo conhecido.

"failure"
O comando de remoção falhou.

StorageAvailableCapacityInfo

Propriedades

  • availableCapacity

    número

    A capacidade disponível do dispositivo de armazenamento, em bytes.

  • ID

    string

    Um id copiado do parâmetro id da função getAvailableCapacity.

StorageUnitInfo

Propriedades

  • capacidade

    número

    A quantidade total do espaço de armazenamento, em bytes.

  • ID

    string

    O ID temporário que identifica exclusivamente o dispositivo de armazenamento. Esse ID vai persistir na mesma execução de um único aplicativo. Ele não será um identificador persistente entre diferentes execuções de um aplicativo ou entre diferentes aplicativos.

  • nome

    string

    O nome da unidade de armazenamento.

  • O tipo de mídia da unidade de armazenamento.

StorageUnitType

Enumeração

"fixed"
O armazenamento tem mídia fixa, por exemplo, disco rígido ou SSD.

"removable"
O armazenamento é removível, por exemplo, um pen drive USB.

"unknown"
O tipo de armazenamento é desconhecido.

Métodos

ejectDevice()

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

Ejetar um dispositivo de armazenamento removível.

Parâmetros

Retorna

  • Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getAvailableCapacity()

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

Recebe a capacidade disponível de um dispositivo de armazenamento id especificado. O id é o ID do dispositivo temporário de StorageUnitInfo.

Parâmetros

Retorna

  • As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getInfo()

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

Receba as informações de armazenamento do sistema. O argumento transmitido ao callback é uma matriz de objetos StorageUnitInfo.

Parâmetros

Retorna

  • Promise<StorageUnitInfo[]>

    Chrome 91+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onAttached

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

Acionado quando um novo armazenamento removível é conectado ao sistema.

Parâmetros

onDetached

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

Disparado quando um armazenamento removível é desconectado do sistema.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (id: string) => void

    • ID

      string