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（省略可）

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

  • プロフィール

    文字列

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

  • scriptCache

    キャッシュ （省略可）

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

  • sqliteMemory

    number（省略可）

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

  • タスクを割り当てられるようにしたいと

    TaskInfo[]

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

  • タイプ

    ProcessType

    プロセスのタイプ。

ProcessType

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

Enum

"browser"

"extension"

"plugin"

"utility"

TaskInfo

プロパティ

  • tabId

    number（省略可）

    オプションのタブ ID（このタスクがレンダラ プロセスで実行されているタブを表す場合）。

  • title

    文字列

    タスクのタイトル。

Methods

getProcessIdForTab()

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

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

パラメータ

  • tabId

    数値

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

  • callback

    関数（省略可）

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

    (processId: number)=>void

    • processId

      数値

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

戻り値

  • Promise<数値>

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

getProcessInfo()

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

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

パラメータ

  • processIds

    数値|数値 []

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

  • includeMemory

    boolean

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

  • callback

    関数（省略可）

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

    (processes: object)=>void

    • プロセス

      オブジェクト

      現在のブラウザ プロセスのライブ子プロセスである、リクエストされた各プロセスの Process オブジェクトのディクショナリで、プロセス ID でインデックス化されています。時間の経過に伴う集計を必要とする指標は、各 Process オブジェクトには入力されません。

戻り値

  • Promise<object>

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

terminate()

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

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

パラメータ

  • processId

    数値

    終了するプロセスの ID。

  • callback

    関数（省略可）

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

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

      プロセスの終了が成功した場合は true、そうでない場合は false です。

戻り値

  • Promise<boolean>

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

イベント

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

    • プロセス

      オブジェクト