chrome.system.storage

refresh date: 2026-09-25 robots: noindex

Descripción

Usa la API de chrome.system.storage para consultar información sobre el 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 ejecutó 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 termine de usarlo.

"no_such_device"
No se conoce ese dispositivo.

"failure"
No se pudo ejecutar el comando de expulsión.

StorageAvailableCapacityInfo

Propiedades

  • availableCapacity

    número

    Es la capacidad disponible del dispositivo de almacenamiento, en bytes.

  • id

    string

    Una copia id del parámetro id de la función getAvailableCapacity.

StorageUnitInfo

Propiedades

  • capacidad

    número

    Es la cantidad total de espacio de almacenamiento, en bytes.

  • id

    string

    Es el ID transitorio que identifica de forma inequívoca el dispositivo de almacenamiento. Este ID será persistente dentro de la misma ejecución de una sola aplicación. No será un identificador persistente entre diferentes ejecuciones de una aplicación ni entre diferentes aplicaciones.

  • nombre

    string

    Es el nombre de la unidad de almacenamiento.

  • Es el tipo de medio de la unidad de almacenamiento.

StorageUnitType

Enum

"fixed"
El almacenamiento tiene medios fijos, p.ej., disco duro o SSD.

"removable"
El almacenamiento es extraíble, p.ej., una unidad de memoria flash USB.

"unknown"
El tipo de almacenamiento es desconocido.

Métodos

ejectDevice()

Promise 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
): Promise<EjectDeviceResultCode>

Expulsa un dispositivo de almacenamiento extraíble.

Parámetros

Muestra

  • Chrome 91 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getAvailableCapacity()

Promesa Canal para desarrolladores 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

Obtiene la capacidad disponible de un dispositivo de almacenamiento id especificado. El id es el ID de dispositivo transitorio de StorageUnitInfo.

Parámetros

Muestra

  • Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getInfo()

Promise 
chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

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

Muestra

  • Promise<StorageUnitInfo[]>

    Chrome 91 y versiones posteriores

    Las promesas solo se admiten en 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

onDetached

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

Se activa cuando se desconecta un almacenamiento extraíble del sistema.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (id: string) => void

    • id

      string