說明
使用 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()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
退出卸除式儲存裝置。
參數
-
id
字串
-
回呼
函式選用
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
字串
-
回呼
函式選用
callback
參數如下所示:(info: StorageAvailableCapacityInfo) => void
傳回
-
Promise<StorageAvailableCapacityInfo>
Manifest V3 以上版本支援 Promise,但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
從系統取得儲存空間資訊。傳遞至回呼的引數是 StorageUnitInfo 物件的陣列。
參數
-
回呼
函式選用
callback
參數如下所示:(info: StorageUnitInfo[]) => void
-
資訊
-
傳回
-
Promise<StorageUnitInfo[]>
Chrome 91 以上版本Manifest V3 以上版本支援 Promise,但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。
活動
onAttached
chrome.system.storage.onAttached.addListener(
callback: function,
)
將新的卸除式儲存裝置連接到系統時觸發。
參數
-
回呼
功能
callback
參數如下所示:(info: StorageUnitInfo) => void
onDetached
chrome.system.storage.onDetached.addListener(
callback: function,
)
當卸除式儲存裝置從系統卸離時觸發。
參數
-
回呼
功能
callback
參數如下所示:(id: string) => void
-
id
字串
-