chrome.processes

説明

chrome.processes API を使用してブラウザのプロセスとやり取りします。

権限

processes

対象

<ph type="x-smartling-placeholder"></ph> Dev チャンネル

型

Cache

プロパティ

  • liveSize

    数値

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

  • サイズ

    数値

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

Process

プロパティ

  • CPU

    数値（省略可）

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

  • cssCache

    キャッシュ （オプション）

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

  • id

    数値

    ブラウザによって提供されるプロセスの一意の ID。

  • imageCache

    キャッシュ （オプション）

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

  • jsMemoryAllocated

    数値（省略可）

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

  • jsMemoryUsed

    数値（省略可）

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

  • naclDebugPort

    数値

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

  • ネットワーク

    数値（省略可）

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

  • osProcessId

    数値

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

  • privateMemory

    数値（省略可）

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

  • プロフィール

    文字列

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

  • scriptCache

    キャッシュ （オプション）

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

  • sqliteMemory

    数値（省略可）

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

  • tasks

    TaskInfo[]

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

  • プロセスのタイプ。

ProcessType

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

列挙型

"browser"

&quot;renderer&quot;

「拡張機能」

「通知」

"plugin"

"worker"

"nacl"

"service_worker"

"utility"

"gpu"

「その他」

TaskInfo

プロパティ

  • tabId

    数値（省略可）

    タブ ID（省略可）。このタスクがレンダラ プロセスで実行されるタブを表す場合。

  • title

    文字列

    タスクのタイトル。

メソッド

getProcessIdForTab()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

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

パラメータ

  • tabId

    数値

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

  • callback

    関数（省略可）

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

    (processId: number) => void

    • processId

      数値

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

戻り値

  • Promise&lt;number&gt;

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

getProcessInfo()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
  callback?: function,
)

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

パラメータ

  • processIds

    数値 |数値 []

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

  • includeMemory

    ブール値

    詳細なメモリ使用量が必要な場合は true。メモリ使用量に関する情報を収集すると、余分な CPU 使用量が発生するため、必要なときにのみクエリを実行する必要があります。

  • callback

    関数（省略可）

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

    (processes: object) => void

    • プロセスの自動化

      オブジェクト

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

戻り値

  • Promise&lt;object&gt;

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

terminate()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

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

パラメータ

  • processId

    数値

    終了するプロセスの ID。

  • callback

    関数（省略可）

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

    (didTerminate: boolean) => void

    • didTerminate

      ブール値

      プロセスが正常に終了した場合は true、それ以外の場合は false です。

戻り値

  • Promise&lt;boolean&gt;

    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

    • プロセスの自動化

      オブジェクト