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 プロセスでは 0。

  • ネットワーク

    number 省略可

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

  • osProcessId

    数値

    OS によって提供されるプロセスの ID。

  • privateMemory

    number 省略可

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

  • プロフィール

    文字列

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

  • scriptCache

    キャッシュ 省略可

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

  • sqliteMemory

    number 省略可

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

  • tasks

    TaskInfo[]

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

  • プロセスのタイプ。

ProcessType

ブラウザ プロセスのタイプ。

列挙型

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"
廃止予定。返されることはありません。

"nacl"

「service_worker」
廃止予定。返されることはありません。

"utility"

「gpu」

"other"

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

    • プロセスの自動化

      オブジェクト

      現在のブラウザ プロセスのライブ子プロセスであるリクエストされた各プロセスの Process オブジェクトのディクショナリ。プロセス ID でインデックスされます。時間の経過に伴う集計が必要な指標は、各 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,
)

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

パラメータ

  • callback

    関数

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

    (processes: object) => void

    • プロセスの自動化

      オブジェクト

onUpdatedWithMemory

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

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

パラメータ

  • callback

    関数

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

    (processes: object) => void

    • プロセスの自動化

      オブジェクト