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 for conectado e desconectado.

Permissões

system.storage

Tipos

EjectDeviceResultCode

Enumeração

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

"in_use"
O dispositivo está em uso por outro aplicativo. A ejeçã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"
Não há nenhum dispositivo conhecido.

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

StorageAvailableCapacityInfo

Propriedades

  • availableCapacity

    number

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

  • id

    string

    Uma id copiada 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 transitó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 diferentes aplicativos.

  • 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, 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,
)

Ejetar um dispositivo de armazenamento removível.

Parâmetros

Retorna

  • Chrome 91 e versões mais recentes

    As promessas têm suporte apenas para o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getAvailableCapacity()

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

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

Parâmetros

Retorna

  • As promessas têm suporte apenas para o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getInfo()

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

Receber 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 e versões mais recentes

    As promessas têm suporte apenas para 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,
)

É acionado quando um armazenamento removível é desconectado do sistema.

Parâmetros

  • callback

    função

    O parâmetro callback tem este formato: 

    (id: string) => void

    • id

      string