chrome.processes

説明

chrome.processes API を使用して、ブラウザのプロセスを操作します。

権限

processes

対象

Dev チャンネル

型

Cache

プロパティ

  • liveSize

    数値

    使用されているキャッシュの部分（バイト単位）。

  • サイズ

    数値

    キャッシュのサイズ（バイト単位）。

Process

プロパティ

  • cpu

    number（省略可）

    プロセスの CPU 使用率の最新の測定値。プロセスのすべてのスレッドによって使用される単一の CPU コアの合計使用率の割合で表されます。値は 0 ～ CpuInfo.numOfProcessors*100 の範囲で、マルチスレッド プロセスでは 100% を超えることがあります。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。

  • cssCache

    キャッシュ 省略可

    プロセスの CSS キャッシュに関する最新情報。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。

  • id

    数値

    ブラウザから提供されたプロセスの一意の ID。

  • imageCache

    キャッシュ 省略可

    プロセスのイメージ キャッシュに関する最新情報。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。

  • jsMemoryAllocated

    number（省略可）

    プロセスの JavaScript が割り当てたメモリの最新の測定値（バイト単位）。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。

  • jsMemoryUsed

    number 省略可

    使用されたプロセスの JavaScript メモリの最新の測定値（バイト単位）。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。

  • naclDebugPort

    数値

    ネイティブ クライアント プロセスのデバッグ ポート。他のプロセスタイプと、デバッグが有効になっていない NaCl プロセスの場合はゼロです。

  • ネットワーク

    number（省略可）

    プロセスのネットワーク使用量の最新の測定値（1 秒あたりのバイト数）。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。

  • osProcessId

    数値

    OS から提供されたプロセスの ID。

  • privateMemory

    number 省略可

    プロセスのプライベート メモリ使用量の最新の測定値（バイト単位）。onUpdatedWithMemory または getProcessInfo（includeMemory フラグあり）からのコールバックの一部としてオブジェクトを受信した場合にのみ使用できます。

  • プロフィール

    文字列

    プロセスが関連付けられているプロファイル。

  • scriptCache

    キャッシュ 省略可

    プロセスのスクリプト キャッシュに関する最新情報。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。

  • sqliteMemory

    number 省略可

    プロセスの SQLite メモリ使用量の最新の測定値（バイト単位）。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。

  • tasks

    TaskInfo[]

    このプロセスで実行されているタスクを表す TaskInfo の配列。

  • プロセスのタイプ。

ProcessType

ブラウザ プロセスの種類。

列挙型

"browser"

「renderer」

「extension」

「通知」

「plugin」

「worker」

「nacl」

「service_worker」
無効。返されることはありません。

「ユーティリティ」

「gpu」

「その他」

TaskInfo

プロパティ

  • tabId

    number（省略可）

    レンダラ プロセスで実行されているタブを表すタブ ID（省略可）。

  • title

    文字列

    タスクのタイトル。

メソッド

getProcessIdForTab()

Promise 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

指定したタブのレンダラ プロセスの ID を返します。

パラメータ

  • tabId

    数値

    レンダラ プロセス ID が返されるタブの ID。

  • callback

    関数（省略可）

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

    (processId: number) => void

    • processId

      数値

      タブのレンダラ プロセスのプロセス ID。

戻り値

  • Promise<number>

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

getProcessInfo()

Promise 
chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
  callback?: function,
)

指定されたプロセス ID ごとにプロセス情報を取得します。

パラメータ

  • processIds

    number | number[]

    プロセス情報を返すプロセス ID のリストまたは単一のプロセス ID。リストが空の場合は、すべてのプロセスがリクエストされていることを示します。

  • includeMemory

    ブール値

    詳細なメモリ使用量が必要な場合は true に設定します。メモリ使用量の情報を収集すると CPU 使用量が増加するため、必要な場合にのみクエリを実行してください。

  • callback

    関数（省略可）

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

    (processes: object) => void

    • プロセスの自動化

      オブジェクト

      現在のブラウザ プロセスのライブ子プロセスであるリクエストされたプロセスごとに、プロセス ID でインデックス付けされた Process オブジェクトの辞書。時間の経過に伴う集計が必要な指標は、各 Process オブジェクトに入力されません。

戻り値

  • Promise<object>

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

terminate()

Promise 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

指定したレンダラ プロセスを終了します。about:crash にアクセスするのと同じですが、タブの URL は変更されません。

パラメータ

  • processId

    数値

    終了するプロセスの ID。

  • callback

    関数（省略可）

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

    (didTerminate: boolean) => void

    • didTerminate

      ブール値

      プロセスの終了が成功した場合は true、それ以外の場合は false。

戻り値

  • Promise<boolean>

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

イベント

onCreated

chrome.processes.onCreated.addListener(
  callback: function,
)

プロセスが作成されるたびに呼び出され、対応する Process オブジェクトを返します。

パラメータ

  • callback

    関数

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

    (process: Process) => void

onExited

chrome.processes.onExited.addListener(
  callback: function,
)

プロセスが終了するたびに呼び出され、終了の種類を指定します。

パラメータ

  • callback

    関数

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

    (processId: number, exitType: number, exitCode: number) => void

    • processId

      数値

    • exitType

      数値

    • exitCode

      数値

onUnresponsive

chrome.processes.onUnresponsive.addListener(
  callback: function,
)

プロセスが応答しなくなるたびにトリガーされ、対応する Process オブジェクトが提供されます。

パラメータ

  • callback

    関数

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

    (process: Process) => void

onUpdated

chrome.processes.onUpdated.addListener(
  callback: function,
)

タスク マネージャーがプロセス統計情報を更新するたびにトリガーされ、更新されたプロセス オブジェクトの辞書（プロセス ID でインデックス付け）を提供します。

パラメータ

  • callback

    関数

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

    (processes: object) => void

    • プロセスの自動化

      オブジェクト

onUpdatedWithMemory

chrome.processes.onUpdatedWithMemory.addListener(
  callback: function,
)

タスク マネージャーがプロセス統計情報を更新するたびにトリガーされ、更新されたプロセス オブジェクトの辞書（プロセス ID でインデックス付け）を提供します。onUpdate と同じですが、各 Process オブジェクトにメモリ使用量の詳細が追加されています。メモリ使用量の情報を収集すると CPU 使用量が増加するため、必要な場合にのみリッスンする必要があります。

パラメータ

  • callback

    関数

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

    (processes: object) => void

    • プロセスの自動化

      オブジェクト