説明
chrome.processes
API を使用して、ブラウザのプロセスとやり取りします。
権限
processes
可用性
型
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 からコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。
-
プロフィール
string
プロセスが関連付けられているプロファイル。
-
scriptCache
キャッシュ (省略可)
プロセスのスクリプト キャッシュに関する最新情報。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。
-
sqliteMemory
number(省略可)
プロセスの SQLite メモリ使用量の最新の測定値(バイト単位)。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受信する場合にのみ使用できます。
-
タスクを割り当てられるようにしたいと
TaskInfo[]
このプロセスで実行されるタスクを表す TaskInfos の配列。
-
type
プロセスのタイプ。
ProcessType
ブラウザ プロセスのタイプ。
列挙型
"browser"
"extension"
"plugin"
"utility"
TaskInfo
プロパティ
-
tabId
number(省略可)
オプションのタブ ID(このタスクがレンダラ プロセスで実行されているタブを表す場合)。
-
title
string
タスクのタイトル。
メソッド
getProcessIdForTab()
chrome.processes.getProcessIdForTab(
tabId: number,
callback?: function,
)
指定されたタブのレンダラ プロセスの ID を返します。
パラメータ
-
tabId
数値
レンダラのプロセス ID が返されるタブの ID。
-
callback
関数(省略可)
callback
パラメータは次のようになります。(processId: number) => void
-
processId
数値
タブのレンダラ プロセスのプロセス ID。
-
戻り値
-
Promise<数値>
Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。
getProcessInfo()
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 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。
terminate()
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 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。
イベント
onCreated
chrome.processes.onCreated.addListener(
callback: function,
)
プロセスが作成されるたびに呼び出され、対応する Process オブジェクトを提供します。
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 オブジェクトを提供します。
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
-
プロセスの自動化
オブジェクト
-