chrome.processes

Description
Use the chrome.processes API to interact with the browser's processes.
Permissions
processes
Availability
Dev channel

Summary

Types
Cache
Process
ProcessType
TaskInfo
Methods
getProcessIdForTab
getProcessInfo
terminate
Events
onCreated
onExited
onUnresponsive
onUpdated
onUpdatedWithMemory

Types

Cache

Properties

liveSize
number
The part of the cache that is utilized, in bytes.
size
number
The size of the cache, in bytes.

Process

Properties

cpu
number optional
The most recent measurement of the process's CPU usage, expressed as the percentage of a single CPU core used in total, by all of the process's threads. This gives a value from zero to CpuInfo.numOfProcessors*100, which can exceed 100% in multi-threaded processes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.
cssCache
Cache optional
The most recent information about the CSS cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.
id
number
Unique ID of the process provided by the browser.
imageCache
Cache optional
The most recent information about the image cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.
jsMemoryAllocated
number optional
The most recent measurement of the process JavaScript allocated memory, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.
jsMemoryUsed
number optional
The most recent measurement of the process JavaScript memory used, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.
naclDebugPort
number
The debugging port for Native Client processes. Zero for other process types and for NaCl processes that do not have debugging enabled.
network
number optional
The most recent measurement of the process network usage, in bytes per second. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.
osProcessId
number
The ID of the process, as provided by the OS.
privateMemory
number optional
The most recent measurement of the process private memory usage, in bytes. Only available when receiving the object as part of a callback from onUpdatedWithMemory or getProcessInfo with the includeMemory flag.
profile
string
The profile which the process is associated with.
scriptCache
Cache optional
The most recent information about the script cache for the process. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.
sqliteMemory
number optional
The most recent measurement of the process's SQLite memory usage, in bytes. Only available when receiving the object as part of a callback from onUpdated or onUpdatedWithMemory.
tasks
TaskInfo[]
Array of TaskInfos representing the tasks running on this process.
type
ProcessType
The type of process.

ProcessType

The types of the browser processes.

Type

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"

"nacl"

"service_worker"

"utility"

"gpu"

, or

"other"

TaskInfo

Properties

tabId
number optional
Optional tab ID, if this task represents a tab running on a renderer process.
title
string
The title of the task.

Methods

getProcessIdForTab

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

Promise

Returns the ID of the renderer process for the specified tab.

Parameters

tabId
number
The ID of the tab for which the renderer process ID is to be returned.
callback
function optional
The callback parameter looks like: (processId: number) => void
- processId
  number
  Process ID of the tab's renderer process.

Returns

Promise<number>
This only returns a Promise when the callback parameter is not specified, and with MV3+. The type inside the Promise is the same as the 1st argument to callback.

getProcessInfo

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

Promise

Retrieves the process information for each process ID specified.

Parameters

processIds
number | number[]
The list of process IDs or single process ID for which to return the process information. An empty list indicates all processes are requested.
includeMemory
boolean
True if detailed memory usage is required. Note, collecting memory usage information incurs extra CPU usage and should only be queried for when needed.
callback
function optional
The callback parameter looks like: (processes: object) => void
- processes
  object
  A dictionary of Process objects for each requested process that is a live child process of the current browser process, indexed by process ID. Metrics requiring aggregation over time will not be populated in each Process object.

Returns

Promise<object>
This only returns a Promise when the callback parameter is not specified, and with MV3+. The type inside the Promise is the same as the 1st argument to callback.

terminate

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

Promise

Terminates the specified renderer process. Equivalent to visiting about:crash, but without changing the tab's URL.

Parameters

processId
number
The ID of the process to be terminated.
callback
function optional
The callback parameter looks like: (didTerminate: boolean) => void
- didTerminate
  boolean
  True if terminating the process was successful, and false otherwise.

Returns

Promise<boolean>
This only returns a Promise when the callback parameter is not specified, and with MV3+. The type inside the Promise is the same as the 1st argument to callback.

Events

onCreated

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

Fired each time a process is created, providing the corrseponding Process object.

Parameters

callback
function
The callback parameter looks like: (process: Process) => void
- process
  Process

onExited

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

Fired each time a process is terminated, providing the type of exit.

Parameters

callback
function
The callback parameter looks like: (processId: number, exitType: number, exitCode: number) => void
- processId
  number
- exitType
  number
- exitCode
  number

onUnresponsive

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

Fired each time a process becomes unresponsive, providing the corrseponding Process object.

Parameters

callback
function
The callback parameter looks like: (process: Process) => void
- process
  Process

onUpdated

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

Fired each time the Task Manager updates its process statistics, providing the dictionary of updated Process objects, indexed by process ID.

Parameters

callback
function
The callback parameter looks like: (processes: object) => void
- processes
  object

onUpdatedWithMemory

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

Fired each time the Task Manager updates its process statistics, providing the dictionary of updated Process objects, indexed by process ID. Identical to onUpdate, with the addition of memory usage details included in each Process object. Note, collecting memory usage information incurs extra CPU usage and should only be listened for when needed.

Parameters

callback
function
The callback parameter looks like: (processes: object) => void
- processes
  object