chrome.system.storage

类型
1. StorageUnitInfo
方法
事件
1. onAttached
2. onDetached

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

chrome.system.storage 参考

类型

StorageUnitInfo

StorageUnitInfo 的属性

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

name ( string ): 存储单元的名称。

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

存储单元的媒体类型。

fixed: 存储器是固定媒体，例如硬盘或 SSD。

removable: 存储器可移动，例如 USB 闪存盘。

unknown: 存储器类型未知。

capacity ( double ): 存储空间的总共大小，以字节为单位。

方法

getInfo

chrome.system.storage.getInfo(function callback)

Get the storage information from the system. The argument passed to the callback is an array of StorageUnitInfo objects. 从系统获取存储信息，传递给回调函数的参数为 StorageUnitInfo 对象的数组。

参数

callback ( function )

callback 参数应该指定一个如下形式的函数：

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

info ( array of StorageUnitInfo )

ejectDevice

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

弹出可移动存储设备。

参数

id ( string )

callback ( function )

callback 参数应该指定一个如下形式的函数：

function(enum of "success", "in_use", "no_such_device", or "failure" result) {...};

result ( enum of "success", "in_use", "no_such_device", or "failure" )

success: The ejection command is successful -- the application can prompt the user to remove the device.

in_use: The device is in use by another application. The ejection did not succeed; the user should not remove the device until the other application is done with the device.

no_such_device: There is no such device known.

failure: The ejection command failed.

getAvailableCapacity

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

获取指定存储设备的可用容量。来自 StorageUnitInfo 的设备标识符。

参数

id ( string )

callback ( function )

callback 参数应该指定一个如下形式的函数：

function(object info) {...};

info ( object )

属性

id ( string ): 从 getAvailableCapacity 函数的 id 参数复制过来的标识符。

availableCapacity ( double ): 存储设备的可用容量，以字节为单位。

事件

onAttached

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

addListener

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

参数

callback ( function )

callback 参数应该指定一个如下形式的函数：

function(StorageUnitInfo info) {...};

info ( StorageUnitInfo )

onDetached

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

addListener

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

参数

callback ( function )

callback 参数应该指定一个如下形式的函数：

function(string id) {...};

id ( string )

chrome.system.storage