chrome.system.storage

描述 使用 chrome.system.storage API 查询存储设备信息,并在连接或移除可移动存储设备时得到通知。
可用版本 从 Chrome 30 开始支持。
权限 "system.storage"

摘要

类型
StorageUnitInfo
方法
getInfo chrome.system.storage.getInfo(function callback)
ejectDevice chrome.system.storage.ejectDevice(string id, function callback)
事件
onAttached
onDetached

类型

StorageUnitInfo

属性
string id

唯一标识存储设备的暂存标识符,标识符在应用程序同一次运行中持久有效,但不会在同一应用程序两次运行或者不同应用程序之间持久保留。

string name

存储单元的名称。

enum of "fixed", "removable", or "unknown" type

存储单元的媒体类型。

fixed
存储器是固定媒体,例如硬盘或 SSD。
removable
存储器可移动,例如 USB 闪存盘。
unknown
存储器类型未知。
double capacity

存储空间的总共大小,以字节为单位。

方法

getInfo

chrome.system.storage.getInfo(function callback)

从系统获取存储信息,传递给回调函数的参数为 StorageUnitInfo 对象的数组。

参数
function callback

callback 参数应该是一个如下形式的函数:

function(array of StorageUnitInfo info) {...};
array of StorageUnitInfo info

ejectDevice

chrome.system.storage.ejectDevice(string id, function callback)

弹出可移动存储设备。

参数
string id
function callback

callback 参数应该是一个如下形式的函数:

function(enum of "success", "in_use", "no_such_device", or "failure" result) {...};
enum of "success", "in_use", "no_such_device", or "failure" result
success
弹出命令成功完成,应用程序可以提示用户拔出设备。
in_use
另一个应用程序正在使用该设备,弹出命令没有成功,用户不应该拔出设备,而应该等另一个应用程序使用完该设备。
no_such_device
指定设备不存在。
failure
弹出命令失败。

事件

onAttached

当可移动存储器连接到系统时产生。

addListener

chrome.system.storage.onAttached.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function( StorageUnitInfo info) {...};
StorageUnitInfo info

onDetached

当可移动设备从系统移除时产生。

addListener

chrome.system.storage.onDetached.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function(string id) {...};
string id