説明
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 プロセスでは 0。
- ネットワーク
number 省略可
プロセスのネットワーク使用量の最新の測定値（バイト/秒）。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受け取るときにのみ使用できます。
- osProcessId
数値
OS によって提供されるプロセスの ID。
- privateMemory
number 省略可
プロセスのプライベート メモリ使用量の最新の測定値（バイト単位）。includeMemory フラグを指定して onUpdatedWithMemory または getProcessInfo からのコールバックの一部としてオブジェクトを受け取った場合にのみ使用できます。
- プロフィール
文字列
プロセスが関連付けられているプロファイル。
- scriptCache
キャッシュ 省略可
プロセスのスクリプト キャッシュに関する最新情報。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受け取るときにのみ使用できます。
- sqliteMemory
number 省略可
プロセスの SQLite メモリ使用量の最新の測定値（バイト単位）。onUpdated または onUpdatedWithMemory からのコールバックの一部としてオブジェクトを受け取るときにのみ使用できます。
- tasks
TaskInfo[]
このプロセスで実行されているタスクを表す TaskInfo の配列。
- type
プロセスのタイプ。
ProcessType
ブラウザ プロセスのタイプ。
列挙型
"browser"
"renderer"
"extension"
"notification"
"plugin"
"worker"
廃止予定。返されることはありません。
"nacl"
「service_worker」
廃止予定。返されることはありません。
"utility"
「gpu」
"other"
TaskInfo
プロパティ
- tabId
number 省略可
このタスクがレンダラ プロセスで実行されているタブを表す場合、タブ ID（省略可）。
- title
文字列
タスクのタイトル。
メソッド
getProcessIdForTab()
chrome.processes.getProcessIdForTab(
tabId: number,
): Promise<number>
指定されたタブのレンダラ プロセスの ID を返します。
パラメータ
- tabId
数値
レンダラ プロセス ID を返すタブの ID。
戻り値
-
Promise<number>
getProcessInfo()
chrome.processes.getProcessInfo(
processIds: number | number[],
includeMemory: boolean,
): Promise<object>
指定された各プロセス ID のプロセス情報を取得します。
パラメータ
- processIds
number | number[]
プロセス情報を返すプロセス ID のリストまたは単一のプロセス ID。リストが空の場合、すべてのプロセスがリクエストされたことを示します。
- includeMemory
ブール値
詳細なメモリ使用量が必要な場合は true。メモリ使用量情報を収集すると CPU 使用量が増加するため、必要な場合にのみクエリを実行してください。
戻り値
-
Promise<object>
terminate()
chrome.processes.terminate(
processId: number,
): Promise<boolean>
指定されたレンダラ プロセスを終了します。about:crash にアクセスするのと同等ですが、タブの URL は変更されません。
パラメータ
- processId
数値
終了するプロセスの ID。
戻り値
-
Promise<boolean>
イベント
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
- プロセスの自動化
オブジェクト
-