說明
使用 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()
browser.system.storage.ejectDevice(
id: string,
): Promise<EjectDeviceResultCode>
退出外接儲存裝置。
參數
-
id
字串
傳回
-
Promise<EjectDeviceResultCode>
Chrome 91 以上版本 Chrome 148 以上版本：browser.*
getAvailableCapacity()
browser.system.storage.getAvailableCapacity(
id: string,
): Promise<StorageAvailableCapacityInfo>
取得指定 id 儲存裝置的可用容量。id 是 StorageUnitInfo 的暫時裝置 ID。
參數
-
id
字串
傳回
-
Promise<StorageAvailableCapacityInfo>
getInfo()
browser.system.storage.getInfo(): Promise<StorageUnitInfo[]>
從系統取得儲存空間資訊。傳遞至回呼的引數是 StorageUnitInfo 物件陣列。
傳回
-
Promise<StorageUnitInfo[]>
Chrome 91 以上版本 Chrome 148 以上版本：browser.*
事件
onAttached
browser.system.storage.onAttached.addListener(
callback: function,
)
當新的抽取式儲存裝置連接到系統時，就會觸發這個事件。
參數
-
callback
函式
callback參數如下：(info: StorageUnitInfo) => void
onDetached
browser.system.storage.onDetached.addListener(
callback: function,
)
當卸除式儲存裝置從系統卸除時，就會觸發這個事件。
參數
-
callback
函式
callback參數如下：(id: string) => void
-
id
字串
-