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

列挙型

"fixed"
ストレージには固定メディアがあります。例:ハードディスクまたは SSD です。

"removable"
ストレージはリムーバブルです。例:USB フラッシュ ドライブ

"unknown"
ストレージの種類が不明です。

メソッド

ejectDevice()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

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

パラメータ

戻り値

  • Promise&lt;EjectDeviceResultCode&gt;

    Chrome 91 以降

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

getAvailableCapacity()

<ph type="x-smartling-placeholder"></ph> 約束 Dev チャンネル をご覧ください。
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

パラメータ

戻り値

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

getInfo()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.system.storage.getInfo(
  callback?: function,
)

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

パラメータ

  • callback

    関数（省略可）

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

    (info: StorageUnitInfo[]) => void

戻り値

  • Promise&lt;StorageUnitInfo[]&gt;

    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

      文字列