説明
chrome.system.storage
API を使用してストレージ デバイス情報をクエリし、リムーバブル ストレージ デバイスの接続時と接続解除時に通知を受け取ることができます。
権限
system.storage
型
EjectDeviceResultCode
列挙型
"success"
取り出しコマンドが成功しました。アプリケーションはユーザーにデバイスの削除を要求できます。
"in_use"
デバイスは別のアプリケーションで使用中です。排出が失敗しました。別のアプリによるデバイスの使用が完了するまで、ユーザーはデバイスを取り外さないでください。
"no_such_device"
既知のデバイスは存在しません。
"failure"
排出コマンドが失敗しました。
StorageAvailableCapacityInfo
プロパティ
-
availableCapacity
数値
ストレージ デバイスの空き容量(バイト単位)。
-
id
文字列
getAvailableCapacity 関数パラメータ
id
のコピーid
。
StorageUnitInfo
プロパティ
-
容量
数値
保存容量の合計量(バイト単位)。
-
id
文字列
ストレージ デバイスを一意に識別する一時的な ID。この ID は、単一のアプリケーションの同じ実行内で持続します。アプリケーションの異なる実行間や異なるアプリケーション間で永続的な識別子にはなりません。
-
name
文字列
ストレージ ユニットの名前。
-
type
ストレージ ユニットのメディアタイプ。
StorageUnitType
列挙型
"fixed"
ストレージには固定メディアがあります。例:ハードディスクまたは SSD です。
"removable"
ストレージはリムーバブルです。例:USB フラッシュ ドライブ
"unknown"
ストレージの種類が不明です。
メソッド
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
リムーバブル ストレージ デバイスを取り出します。
パラメータ
-
id
文字列
-
callback
関数(省略可)
callback
パラメータは次のようになります。(result: EjectDeviceResultCode) => void
戻り値
-
Promise<EjectDeviceResultCode>
Chrome 91 以降Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
)
指定した id
ストレージ デバイスの空き容量を取得します。id
は、StorageUnitInfo からの一時的なデバイス ID です。
パラメータ
-
id
文字列
-
callback
関数(省略可)
callback
パラメータは次のようになります。(info: StorageAvailableCapacityInfo) => void
戻り値
-
Promise<StorageAvailableCapacityInfo>
Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
システムからストレージ情報を取得します。コールバックに渡される引数は StorageUnitInfo オブジェクトの配列です。
パラメータ
-
callback
関数(省略可)
callback
パラメータは次のようになります。(info: StorageUnitInfo[]) => void
-
情報
-
戻り値
-
Promise<StorageUnitInfo[]>
Chrome 91 以降Promise は 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
文字列
-