chrome.system.storage

Descrição

Use a API chrome.system.storage para consultar informações do dispositivo de armazenamento e receber uma notificação quando um dispositivo de armazenamento removível for conectado e removido.

Permissões

system.storage

Tipos

EjectDeviceResultCode

Tipo enumerado

"success"
O comando de expulsão foi concluído. O aplicativo pode solicitar que o usuário remova o dispositivo.

"in_use"
O dispositivo está sendo usado por outro aplicativo. A expulsão não foi bem-sucedida. O usuário não deve remover o dispositivo até que o outro aplicativo termine de usá-lo.

"no_such_device"
Esse dispositivo não é conhecido.

"falha"
O comando de expulsão falhou.

StorageAvailableCapacityInfo

Propriedades

  • availableCapacity

    number

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

  • id

    string

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

StorageUnitInfo

Propriedades

  • capacidade

    number

    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 será persistente na mesma execução de um único aplicativo. Ele não será um identificador persistente entre execuções diferentes de um aplicativo ou entre aplicativos diferentes.

  • name

    string

    O nome da unidade de armazenamento.

  • digitar

    StorageUnitType

    O tipo de mídia da unidade de armazenamento.

StorageUnitType

Tipo enumerado

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

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

"desconhecido"
O tipo de armazenamento é desconhecido.

Métodos

ejectDevice()

Promessa 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

Ejeta um dispositivo de armazenamento removível.

Parâmetros

Retorna

  • Chrome 91 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

getAvailableCapacity()

Promessa Canal de Desenvolvedor 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

Parâmetros

Retorna

  • Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

getInfo()

Promessa 
chrome.system.storage.getInfo(
  callback?: function,
)

Acesse as informações de armazenamento do sistema. O argumento transmitido ao retorno de chamada é uma matriz de objetos StorageUnitInfo.

Parâmetros

Retorna

  • Promise<StorageUnitInfo[]>

    Chrome 91 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

Eventos

onAttached

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

Disparado 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 é removido do sistema.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (id: string)=>void

    • id

      string