refresh date: 2026-09-25 robots: noindex
說明
使用 chrome.system.storage API 查詢儲存裝置資訊，並在可移除式儲存裝置連接及卸除時收到通知。
權限
system.storage類型
EjectDeviceResultCode
列舉
「success」
退出指令成功，應用程式可以提示使用者移除裝置。
「in_use」
裝置正在供其他應用程式使用。彈出失敗；在其他應用程式完成裝置作業前，使用者不應移除裝置。
"no_such_device"
There is no such device known.
「failure」
彈出指令失敗。
StorageAvailableCapacityInfo
屬性
-
availableCapacity
數字
儲存裝置的可用容量 (以位元組為單位)。
-
id
字串
複製的
idgetAvailableCapacity 函式參數id。
StorageUnitInfo
屬性
-
容量
數字
儲存空間總量 (以位元組為單位)。
-
id
字串
可明確識別儲存裝置的暫時性 ID。這個 ID 在單一應用程式的相同執行階段內會保持不變。這個 ID 不會是應用程式不同執行作業之間，或不同應用程式之間的持續性 ID。
-
名稱
字串
儲存單元名稱。
-
儲存單元的媒體類型。
StorageUnitType
列舉
「fixed」
儲存空間具有固定媒體，例如硬碟或 SSD。
「可移除」
儲存空間可移除，例如 USB 隨身碟。
「unknown」
儲存空間類型不明。
方法
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
): Promise<EjectDeviceResultCode>
退出可移除式儲存裝置。
參數
-
id
字串
-
callback
函式 選填
callback參數如下：(result: EjectDeviceResultCode) => void
傳回
-
Promise<EjectDeviceResultCode>
Chrome 91 以上版本只有 Manifest V3 以上版本支援 Promise，其他平台則需使用回呼。
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
): Promise<StorageAvailableCapacityInfo>
取得指定id儲存裝置的可用容量。id 是 StorageUnitInfo 中的暫時性裝置 ID。
參數
-
id
字串
-
callback
函式 選填
callback參數如下：(info: StorageAvailableCapacityInfo) => void
傳回
-
Promise<StorageAvailableCapacityInfo>
只有 Manifest V3 以上版本支援 Promise，其他平台則需使用回呼。
getInfo()
chrome.system.storage.getInfo(
callback?: function,
): Promise<StorageUnitInfo[]>
從系統取得儲存空間資訊。傳遞至回呼的引數是 StorageUnitInfo 物件陣列。
參數
-
callback
函式 選填
callback參數如下：(info: StorageUnitInfo[]) => void
-
資訊
-
傳回
-
Promise<StorageUnitInfo[]>
Chrome 91 以上版本只有 Manifest V3 以上版本支援 Promise，其他平台則需使用回呼。
事件
onAttached
chrome.system.storage.onAttached.addListener(
callback: function,
)
當新的卸除式儲存裝置連接到系統時，就會觸發此事件。
參數
-
callback
函式
callback參數如下：(info: StorageUnitInfo) => void
onDetached
chrome.system.storage.onDetached.addListener(
callback: function,
)
當可移除式儲存裝置從系統中卸載時，就會觸發此事件。
參數
-
callback
函式
callback參數如下：(id: string) => void
-
id
字串
-