refresh date: 2026-09-25 robots: noindex
说明
使用 chrome.system.storage API 查询存储设备信息，并在可移除存储设备连接和断开连接时收到通知。
权限
system.storage类型
EjectDeviceResultCode
枚举
“success”
弹出命令成功执行 - 应用可以提示用户移除设备。
“in_use”
设备正在被其他应用使用。弹出失败；在其他应用完成对设备的操作之前，用户不应移除设备。
"no_such_device"
找不到相应设备。
“失败”
弹出命令失败。
StorageAvailableCapacityInfo
属性
-
availableCapacity
数值
存储设备的可用容量（以字节为单位）。
-
id
字符串
复制的 getAvailableCapacity 函数形参
id的id。
StorageUnitInfo
属性
-
容量
数值
存储空间总量（以字节为单位）。
-
id
字符串
唯一标识存储设备的临时 ID。此 ID 在单个应用的同一运行期间内保持不变。它不会成为应用的不同运行之间或不同应用之间的持久性标识符。
-
name
字符串
存储单元的名称。
-
存储单元的媒体类型。
StorageUnitType
枚举
“固定”
存储介质是固定的，例如硬盘或 SSD。
“可移动”
存储空间可移动，例如 U 盘。
“未知”
存储类型未知。
方法
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
): Promise<EjectDeviceResultCode>
弹出可移动存储设备。
参数
-
id
字符串
-
callback
函数 可选
callback参数如下所示：(result: EjectDeviceResultCode) => void
返回
-
Promise<EjectDeviceResultCode>
Chrome 91 及更高版本仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
): Promise<StorageAvailableCapacityInfo>
获取指定 id 存储设备的可用容量。id 是来自 StorageUnitInfo 的临时设备 ID。
参数
-
id
字符串
-
callback
函数 可选
callback参数如下所示：(info: StorageAvailableCapacityInfo) => void
返回
-
Promise<StorageAvailableCapacityInfo>
仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
getInfo()
chrome.system.storage.getInfo(
callback?: function,
): Promise<StorageUnitInfo[]>
从系统获取存储空间信息。传递给回调的实参是 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
string
-