chrome.system.storage

说明

使用 chrome.system.storage API 查询存储设备信息，并在连接和分离可移动存储设备时接收通知。

权限

system.storage

类型

EjectDeviceResultCode

枚举

"success"
移除命令成功 - 应用可以提示用户移除设备。

"in_use"
其他应用正在使用该设备。移除未成功；在其他应用使用完设备之前，用户不得移除设备。

"no_such_device"
尚无此类设备。

"failure"
移除命令失败。

StorageAvailableCapacityInfo

属性

  • availableCapacity

    number

    存储设备的可用容量（以字节为单位）。

  • id

    string

    getAvailableCapacity 函数参数 id 的复制 id。

StorageUnitInfo

属性

  • 容量

    number

    存储空间总量（以字节为单位）。

  • id

    string

    唯一标识存储设备的瞬时 ID。此 ID 在单个应用的同一运行过程中将保持不变。它不是应用的不同运行之间或不同应用之间的永久性标识符。

  • name

    string

    存储单元的名称。

  • 存储器的媒体类型。

StorageUnitType

枚举

"fixed"
存储设备具有固定介质，如硬盘或 SSD。

"removable"
存储设备是可移动的，例如 U 盘。

"unknown"
存储类型未知。

方法

ejectDevice()

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

弹出可移动存储设备。

参数

返回

  • Chrome 91 及更高版本

    Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。

getAvailableCapacity()

Promise 开发者版 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

获取指定 id 存储设备的可用容量。id 是来自 StorageUnitInfo 的瞬态设备 ID。

参数

返回

  • Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。

getInfo()

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

从系统获取存储信息。传递给回调函数的参数是 StorageUnitInfo 对象的数组。

参数

返回

  • Promise<StorageUnitInfo[]>

    Chrome 91 及更高版本

    Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。

活动

onAttached

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

在新的可移动存储设备连接到系统时触发。

参数

onDetached

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

在可移动存储设备与系统分离时触发。

参数

  • callback

    功能

    callback 参数如下所示：

    (id: string)=>void

    • id

      string