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 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

getAvailableCapacity()

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

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

パラメータ

戻り値

  • Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

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 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

イベント

onAttached

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

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

パラメータ

onDetached

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

リムーバブル ストレージがシステムから接続解除されたときに呼び出されます。

パラメータ

  • callback

    関数

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

    (id: string) => void

    • id

      文字列