说明
使用 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。
“removable”
存储设备是可拆卸的，例如 U 盘。
“unknown”
存储类型未知。
方法
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
弹出可移动存储设备。
参数
-
id
字符串
-
callback
函数（可选）
callback参数如下所示：(result: EjectDeviceResultCode) => void
返回
-
Promise<EjectDeviceResultCode>
Chrome 91 及更高版本只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
)
获取指定 id 存储设备的可用容量。id 是 StorageUnitInfo 中的暂时性设备 ID。
参数
-
id
字符串
-
callback
函数（可选）
callback参数如下所示：(info: StorageAvailableCapacityInfo) => void
返回
-
Promise<StorageAvailableCapacityInfo>StorageAvailableCapacityInfo
只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
从系统获取存储信息。传递给回调的参数是 StorageUnitInfo 对象的数组。
参数
-
callback
函数（可选）
callback参数如下所示：(info: StorageUnitInfo[]) => void
-
资讯
-
返回
-
Promise<StorageUnitInfo[]>
Chrome 91 及更高版本只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
事件
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
字符串
-