chrome.system.storage

説明

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

    文字列

    ストレージ ユニットの名前。

  • ストレージ ユニットのメディアタイプ。

StorageUnitType

列挙型

「固定」
ストレージに固定メディア（ハードディスクや SSD など）が含まれています。

「removable」
ストレージが取り外し可能（USB フラッシュ ドライブなど）です。

「unknown」
ストレージ タイプが不明です。

メソッド

ejectDevice()

Promise 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

リムーバブル ストレージ デバイスを取り外します。

パラメータ

戻り値

  • Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getAvailableCapacity()

Promise Dev チャンネル 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

指定された id ストレージ デバイスの空き容量を取得します。id は、StorageUnitInfo の一時デバイス ID です。

パラメータ

戻り値

  • Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

getInfo()

Promise 
chrome.system.storage.getInfo(
  callback?: function,
)

システムからストレージ情報を取得します。コールバックに渡される引数は、StorageUnitInfo オブジェクトの配列です。

パラメータ

  • callback

    function 省略可

    callback パラメータは次のようになります。 

    (info: StorageUnitInfo[]) => void

戻り値

  • Promise<StorageUnitInfo[]>

    Chrome 91 以降

    Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。

イベント

onAttached

chrome.system.storage.onAttached.addListener(
  callback: function,
)

新しい取り外し可能なストレージがシステムに接続されたときにトリガーされます。

パラメータ

onDetached

chrome.system.storage.onDetached.addListener(
  callback: function,
)

リムーバブル ストレージがシステムから取り外されたときにトリガーされます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (id: string) => void

    • id

      文字列