browser.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 は、1 つのアプリケーションの同じ実行内で永続的に使用されます。アプリケーションの異なる実行間、または異なるアプリケーション間で永続的な識別子になることはありません。

  • name

    文字列

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

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

StorageUnitType

列挙型

"fixed"
ストレージに固定メディア（ハードディスク、SSD など）がある。

"removable"
ストレージがリムーバブル（USB フラッシュ ドライブなど）であることを示します。

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

メソッド

ejectDevice()

browser.system.storage.ejectDevice(
  id: string,
): Promise<EjectDeviceResultCode>

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

パラメータ

  • id

    文字列

戻り値

getAvailableCapacity()

Dev チャンネル 
browser.system.storage.getAvailableCapacity(
  id: string,
): Promise<StorageAvailableCapacityInfo>

指定された id ストレージ デバイスの使用可能な容量を取得します。id は、StorageUnitInfo の一時的なデバイス ID です。

パラメータ

  • id

    文字列

戻り値

getInfo()

browser.system.storage.getInfo(): Promise<StorageUnitInfo[]>

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

戻り値

  • Promise<StorageUnitInfo[]>

    Chrome 91 以降 Chrome 148 以降の browser.*

イベント

onAttached

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

新しいリムーバブル ストレージがシステムに接続されたときに呼び出されます。

パラメータ

onDetached

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

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

パラメータ

  • callback

    関数

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

    (id: string) => void

    • id

      文字列