chrome.system.storage

说明

您可以使用 chrome.system.storage API 查询存储设备信息，并在连接和分离可移动存储设备时收到通知。

权限

system.storage

类型

EjectDeviceResultCode

枚举

"success"
移除命令成功执行 - 应用可以提示用户移除设备。

"in_use"
设备正被其他应用使用。移除失败；在其他应用完成对设备的操作之前，用户不得移除设备。

"no_such_device"
没有已知的此类设备。

"failure"
移除命令失败。

StorageAvailableCapacityInfo

属性

  • availableCapacity

    number

    存储设备的可用容量（以字节为单位）。

  • id

    字符串

    getAvailableCapacity 函数参数 id 的 id。

StorageUnitInfo

属性

  • 容量

    number

    存储空间总量（以字节为单位）。

  • id

    字符串

    唯一标识存储设备的临时 ID。此 ID 在单个应用的同一运行时内保持不变。它不是应用的不同运行之间或不同应用之间的永久性标识符。

  • name

    字符串

    存储单元的名称。

  • 存储单元的媒体类型。

StorageUnitType

枚举

"fixed"
存储具有固定介质，例如或 SSD。

"removable"
存储空间可移动，例如U 盘。

"unknown"
存储类型未知。

方法

ejectDevice()

<ph type="x-smartling-placeholder"></ph> 承诺 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

弹出可移动存储设备。

参数

返回

  • Promise&lt;EjectDeviceResultCode&gt;

    Chrome 91 及更高版本

    Manifest V3 及更高版本支持 Promise，但为以下项目提供回调： 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。

getAvailableCapacity()

<ph type="x-smartling-placeholder"></ph> 承诺 开发者版 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

获取指定 id 存储设备的可用容量。id 是 StorageUnitInfo 中的临时设备 ID。

参数

返回

  • Manifest V3 及更高版本支持 Promise，但为以下项目提供回调： 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。

getInfo()

<ph type="x-smartling-placeholder"></ph> 承诺 
chrome.system.storage.getInfo(
  callback?: function,
)

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

参数

返回

  • Promise&lt;StorageUnitInfo[]&gt;

    Chrome 91 及更高版本

    Manifest V3 及更高版本支持 Promise，但为以下项目提供回调： 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。

事件

onAttached

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

在系统上附加了新的可移动存储设备时触发。

参数

onDetached

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

将可移动存储设备与系统分离时触发。

参数

  • callback

    函数

    callback 参数如下所示： 

    (id: string) => void

    • id

      字符串