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