Descripción
Usa la API de chrome.system.storage
para consultar la información del dispositivo de almacenamiento y recibir notificaciones cuando se conecte y desconecte un dispositivo de almacenamiento extraíble.
Permisos
system.storage
Tipos
EjectDeviceResultCode
Enum
"success"
El comando de expulsión se ejecuta correctamente: la aplicación puede solicitarle al usuario que quite el dispositivo.
"in_use"
Otra aplicación está usando el dispositivo. La expulsión no se realizó correctamente; el usuario no debe quitar el dispositivo hasta que la otra aplicación haya terminado de usarlo.
"no_such_device"
No existe ese dispositivo conocido.
“error”
Falló el comando de expulsión.
StorageAvailableCapacityInfo
Propiedades
-
availableCapacity
número
Es la capacidad disponible del dispositivo de almacenamiento, en bytes.
-
id
cadena
Se copió
id
del parámetro de función getAvailableCapacityid
.
StorageUnitInfo
Propiedades
-
capacidad
número
Es la cantidad total del espacio de almacenamiento, en bytes.
-
id
cadena
El ID transitorio que identifica de forma exclusiva el dispositivo de almacenamiento. Este ID será persistente en la misma ejecución de una sola aplicación. No será un identificador persistente entre las diferentes ejecuciones de una aplicación o entre distintas aplicaciones.
-
name
cadena
Es el nombre de la unidad de almacenamiento.
-
tipo
Es el tipo de medio de la unidad de almacenamiento.
StorageUnitType
Enum
"fixed"
El almacenamiento tiene medios fijos, p.ej., un disco duro o SSD.
“Extraíble”
El almacenamiento es extraíble, p.ej., una unidad de memoria flash USB.
"desconocido"
El tipo de almacenamiento es desconocido.
Métodos
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
Expulsa un dispositivo de almacenamiento extraíble.
Parámetros
-
id
cadena
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(result: EjectDeviceResultCode) => void
-
resultado
-
Devuelve
-
Promise<EjectDeviceResultCode>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
)
Obtén la capacidad disponible de un dispositivo de almacenamiento específico de id
. id
es el ID de dispositivo transitorio de StorageUnitInfo.
Parámetros
-
id
cadena
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(info: StorageAvailableCapacityInfo) => void
Devuelve
-
Promise<StorageAvailableCapacityInfo>
Las promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
Obtén la información de almacenamiento del sistema. El argumento que se pasa a la devolución de llamada es un array de objetos StorageUnitInfo.
Parámetros
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:(info: StorageUnitInfo[]) => void
-
info
-
Devuelve
-
Promise<StorageUnitInfo[]>
Chrome 91 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
Eventos
onAttached
chrome.system.storage.onAttached.addListener(
callback: function,
)
Se activa cuando se conecta un nuevo almacenamiento extraíble al sistema.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(info: StorageUnitInfo) => void
-
info
-
onDetached
chrome.system.storage.onDetached.addListener(
callback: function,
)
Se activa cuando se desconecta el almacenamiento extraíble del sistema.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:(id: string) => void
-
id
cadena
-