更新日: 2026-09-25 robots: noindex
説明
chrome.system.storage API を使用して、ストレージ デバイス情報をクエリし、リムーバブル ストレージ デバイスが接続または切断されたときに通知を受け取ります。
権限
system.storage型
EjectDeviceResultCode
列挙型
"success"
取り出しコマンドが成功しました。アプリはユーザーにデバイスの取り外しを促すことができます。
"in_use"
デバイスは別のアプリケーションで使用されています。取り出しは成功しませんでした。他のアプリがデバイスの使用を終了するまで、ユーザーはデバイスを取り外さないでください。
"no_such_device"
そのようなデバイスは認識されていません。
"failure"
取り出しコマンドが失敗しました。
StorageAvailableCapacityInfo
プロパティ
-
availableCapacity
数値
ストレージ デバイスの空き容量（バイト単位）。
-
id
文字列
getAvailableCapacity 関数パラメータ
idのコピーされたid。
StorageUnitInfo
プロパティ
-
容量
数値
ストレージ容量の合計（バイト単位）。
-
id
文字列
ストレージ デバイスを一意に識別する一時的な ID。この ID は、1 つのアプリケーションの同じ実行内で永続的に使用されます。アプリケーションの異なる実行間、または異なるアプリケーション間で永続的な識別子になることはありません。
-
name
文字列
ストレージ ユニットの名前。
-
type
ストレージ ユニットのメディアタイプ。
StorageUnitType
列挙型
"fixed"
ストレージに固定メディア（ハードディスク、SSD など）がある。
"removable"
ストレージがリムーバブル（USB フラッシュ ドライブなど）であることを示します。
"unknown"
ストレージ タイプが不明です。
メソッド
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
): Promise<EjectDeviceResultCode>
リムーバブル ストレージ デバイスを取り外します。
パラメータ
-
id
文字列
-
callback
function 省略可
callbackパラメータは次のようになります。(result: EjectDeviceResultCode) => void
戻り値
-
Promise<EjectDeviceResultCode>
Chrome 91 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
): Promise<StorageAvailableCapacityInfo>
指定された id ストレージ デバイスの使用可能な容量を取得します。id は、StorageUnitInfo の一時的なデバイス ID です。
パラメータ
-
id
文字列
-
callback
function 省略可
callbackパラメータは次のようになります。(info: StorageAvailableCapacityInfo) => void
戻り値
-
Promise<StorageAvailableCapacityInfo>
Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
getInfo()
chrome.system.storage.getInfo(
callback?: function,
): Promise<StorageUnitInfo[]>
システムからストレージ情報を取得します。コールバックに渡される引数は、StorageUnitInfo オブジェクトの配列です。
パラメータ
-
callback
function 省略可
callbackパラメータは次のようになります。(info: StorageUnitInfo[]) => void
-
情報
-
戻り値
-
Promise<StorageUnitInfo[]>
Chrome 91 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
イベント
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
文字列
-