refresh date: 2026-09-25 robots: noindex
说明
使用 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
枚举
"fixed"
存储设备具有固定介质，例如硬盘或 SSD。
“removable”
存储设备可拆卸，例如 USB 闪存盘。
"unknown"
存储类型未知。
方法
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
-