chrome.system.storage

說明

使用 chrome.system.storage API 查詢儲存裝置資訊，並在卸除式儲存裝置連接和卸離時接收通知。

權限

system.storage

類型

EjectDeviceResultCode

列舉

"success"
排除指令成功，應用程式可提示使用者移除裝置。

"in_use"
已有其他應用程式正在使用裝置。排除作業未成功；在其他應用程式完成裝置前，使用者不應移除裝置。

"no_such_device"
找不到這類裝置。

"failure"
排除指令失敗。

StorageAvailableCapacityInfo

屬性

  • availableCapacity

    號碼

    儲存裝置的可用容量，以位元組為單位。

  • id

    字串

    已複製 getAvailableCapacity 函式參數 id 的 id。

StorageUnitInfo

屬性

  • 容量

    號碼

    儲存空間的總量，以位元組為單位。

  • id

    字串

    可識別儲存裝置的暫時 ID。此 ID 會在單一應用程式相同執行內永久存在。在應用程式不同執行作業之間，或不同應用程式之間，ID 並不會成為永久 ID。

  • 名稱

    字串

    儲存裝置的名稱。

  • 儲存體單位的媒體類型。

StorageUnitType

列舉

"fixed"
儲存裝置有固定的媒體，例如硬碟或 SSD。

"卸除式"
是可拆卸的儲存裝置，例如 USB 隨身碟。

"unknown"
儲存空間類型不明。

方法

ejectDevice()

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

退出卸除式儲存裝置。

參數

傳回

  • Chrome 91 以上版本

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。

getAvailableCapacity()

Promise 開發人員版 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

取得指定 id 儲存裝置的可用容量。id 是 StorageUnitInfo 的暫時性裝置 ID。

參數

傳回

  • Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。

getInfo()

Promise 
chrome.system.storage.getInfo(
  callback?: function,
)

從系統取得儲存空間資訊。傳遞至回呼的引數是 StorageUnitInfo 物件的陣列。

參數

傳回

  • Promise<StorageUnitInfo[]>

    Chrome 91 以上版本

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。

活動

onAttached

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

將新的卸除式儲存裝置連接到系統時觸發。

參數

onDetached

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

當卸除式儲存裝置從系統卸離時觸發。

參數

  • 回呼

    功能

    callback 參數如下所示： 

    (id: string)=>void

    • id

      字串