说明
使用 chrome.system.storage API 查询存储设备信息，并在可移除存储设备连接和断开连接时收到通知。
权限
system.storage类型
EjectDeviceResultCode
枚举
“success”
弹出命令成功执行 - 应用可以提示用户移除设备。
“in_use”
设备正被其他应用使用。弹出失败；在其他应用完成对设备的操作之前，用户不应移除设备。
"no_such_device"
没有已知的此类设备。
“failure”
弹出命令失败。
StorageAvailableCapacityInfo
属性
-
availableCapacity
数值
存储设备的可用容量（以字节为单位）。
-
id
字符串
复制的 getAvailableCapacity 函数形参
id的id。
StorageUnitInfo
属性
-
容量
数值
存储空间总量（以字节为单位）。
-
id
字符串
唯一标识存储设备的临时 ID。此 ID 在单个应用的同一运行期间将保持不变。它不会成为应用的不同运行之间或不同应用之间的持久性标识符。
-
name
字符串
存储单元的名称。
-
存储单元的媒体类型。
StorageUnitType
枚举
“固定”
存储介质固定，例如硬盘或 SSD。
“可移除”
存储设备可移除，例如 U 盘。
“未知”
存储类型未知。
方法
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
): Promise<EjectDeviceResultCode>
弹出可移除存储设备。
参数
-
id
字符串
返回
-
Promise<EjectDeviceResultCode>
Chrome 91 及更高版本
getAvailableCapacity()
开发者渠道
chrome.system.storage.getAvailableCapacity(
id: string,
): Promise<StorageAvailableCapacityInfo>
获取指定 id 存储设备的可用容量。id 是 StorageUnitInfo 中的临时设备 ID。
参数
-
id
字符串
返回
-
Promise<StorageAvailableCapacityInfo>
getInfo()
chrome.system.storage.getInfo(): Promise<StorageUnitInfo[]>
从系统获取存储空间信息。传递给回调的实参是一个 StorageUnitInfo 对象数组。
返回
-
Promise<StorageUnitInfo[]>
Chrome 91 及更高版本
事件
onAttached
chrome.system.storage.onAttached.addListener(
callback: function,
)
当新的可移除存储设备连接到系统时触发。
参数
-
callback
函数
callback参数如下所示：(info: StorageUnitInfo) => void
onDetached
chrome.system.storage.onDetached.addListener(
callback: function,
)
当可移除存储设备从系统分离时触发。
参数
-
callback
函数
callback参数如下所示：(id: string) => void
-
id
字符串
-