说明
使用 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()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
弹出可移动存储设备。
参数
-
id
string
-
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
string
-
callback
函数(可选)
callback
参数如下所示:(info: StorageAvailableCapacityInfo) => void
返回
-
Promise<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
string
-