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 getAvailableCapacityid
.
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
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()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
Ejeta um dispositivo de armazenamento removível.
Parâmetros
-
id
string
-
callback
função optional
O parâmetro
callback
tem esta aparência:(result: EjectDeviceResultCode) => void
-
resultado
-
Retorna
-
Promise<EjectDeviceResultCode>
Chrome 91 ou mais recentePromessas 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()
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
-
id
string
-
callback
função optional
O parâmetro
callback
tem esta aparência:(info: StorageAvailableCapacityInfo) => void
-
informações
-
Retorna
-
Promise<StorageAvailableCapacityInfo>
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()
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
-
callback
função optional
O parâmetro
callback
tem esta aparência:(info: StorageUnitInfo[]) => void
-
informações
-
Retorna
-
Promise<StorageUnitInfo[]>
Chrome 91 ou mais recentePromessas 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
-
callback
função
O parâmetro
callback
tem esta aparência:(info: StorageUnitInfo) => void
-
informações
-
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
-