chrome.system.storage

Descrição

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

Permissões

system.storage

Tipos

EjectDeviceResultCode

Enumeração

"success"
O comando de expulsão é bem-sucedido. 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 deu certo; o usuário não deve remover o dispositivo até que o outro aplicativo termine de usá-lo.

"no_such_device"
Não existe esse dispositivo conhecido.

"failure"
Falha no comando de ejeção.

StorageAvailableCapacityInfo

Propriedades

  • availableCapacity

    number

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

  • id

    string

    Um id copiado do parâmetro da 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 diferentes execuções de um aplicativo ou entre aplicativos diferentes.

  • nome

    string

    O nome da unidade de armazenamento.

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

StorageUnitType

Enumeração

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

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

"unknown"
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

  • Promise<EjectDeviceResultCode>

    Chrome 91 ou versões mais recentes

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

getAvailableCapacity()

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

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

Parâmetros

Retorna

  • O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

getInfo()

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

Consiga as informações de armazenamento do sistema. O argumento transmitido para o callback é uma matriz de objetos StorageUnitInfo.

Parâmetros

Retorna

  • Promise<StorageUnitInfo[]>

    Chrome 91 ou versões mais recentes

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

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