說明
使用 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。
-
名稱
字串
儲存單位的名稱。
-
儲存單位的媒體類型,
StorageUnitType
列舉
"fixed"
儲存空間有固定的媒體,例如或固態硬碟 (SSD)
"removable"
儲存裝置可移除,例如USB 隨身碟。
"unknown"
這個儲存空間類型不明。
方法
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
退出卸除式儲存裝置。
參數
-
id
字串
-
回呼
函式 選用
callback
參數如下所示:(result: EjectDeviceResultCode) => void
傳回
-
Promise<EjectDeviceResultCode>
Chrome 91 以上版本Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
)
取得指定 id
儲存裝置的可用容量。id
是 StorageUnitInfo 中的暫時性裝置 ID。
參數
-
id
字串
-
回呼
函式 選用
callback
參數如下所示:(info: StorageAvailableCapacityInfo) => void
傳回
-
Promise<StorageAvailableCapacityInfo>
Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
從系統取得儲存空間資訊。傳遞至回呼的引數是 StorageUnitInfo 物件的陣列。
參數
-
回呼
函式 選用
callback
參數如下所示:(info: StorageUnitInfo[]) => void
-
資訊
-
傳回
-
Promise<StorageUnitInfo[]>
Chrome 91 以上版本Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。
活動
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
字串
-