chrome.system.storage

説明

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

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

StorageUnitType

Enum

"fixed"
ストレージには、ハードディスクや SSD などの固定メディアが含まれています。

"removable"
USB フラッシュ ドライブなど、取り外し可能なストレージ。

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

Methods

ejectDevice()

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

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

パラメータ

戻り値

  • Chrome 91 以降

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

getAvailableCapacity()

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

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

パラメータ

戻り値

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

getInfo()

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

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

パラメータ

戻り値

  • Promise<StorageUnitInfo[]>

    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

      文字列