chrome.processes (original) (raw)

Skip to main content

• Docs

  • Overview
  • Get Started
  • Develop
  • How To
  • AI
  • Reference
  • Samples
  • Chrome Web Store

• Case studies

• Blog

• New in Chrome

• Manifest V3

• ➡ Manifest V2

• accessibilityFeatures

• action

• alarms

• audio

• bookmarks

• browsingData

• certificateProvider

• commands

• contentSettings

• contextMenus

• cookies

• debugger

• declarativeContent

• declarativeNetRequest

• desktopCapture

• devtools.inspectedWindow

• devtools.network

• devtools.panels

• devtools.performance

• devtools.recorder

• dns

• documentScan

• dom

• downloads

• enterprise.deviceAttributes

• enterprise.hardwarePlatform

• enterprise.login

• enterprise.networkingAttributes

• enterprise.platformKeys

• events

• extension

• extensionTypes

• fileBrowserHandler

• fileSystemProvider

• fontSettings

• gcm

• history

• i18n

• identity

• idle

• input.ime

• instanceID

• loginState

• management

• notifications

• offscreen

• omnibox

• pageCapture

• permissions

• platformKeys

• power

• printerProvider

• printing

• printingMetrics

• privacy

• processes

• proxy

• readingList

• runtime

• scripting

• search

• sessions

• sidePanel

• storage

• system.cpu

• system.display

• system.memory

• system.storage

• systemLog

• tabCapture

• tabGroups

• tabs

• topSites

• tts

• ttsEngine

• types

• userScripts

• vpnProvider

• wallpaper

• webAuthenticationProxy

• webNavigation

• webRequest

• windows

chrome.processes

Description

Use the chrome.processes API to interact with the browser's processes.

Permissions

processes

Availability

Types

Cache

Properties

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

Process

Properties

• 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.
• 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.
• 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.
• The debugging port for Native Client processes. Zero for other process types and for NaCl processes that do not have debugging enabled.
• 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.
• 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.
• 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.
• Array of TaskInfos representing the tasks running on this process.
• The type of process.

ProcessType

The types of the browser processes.

Enum

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"
Obsolete, will never be returned.

"nacl"

"service_worker"
Obsolete, will never be returned.

"utility"

"gpu"

"other"

TaskInfo

Properties

• Optional tab ID, if this task represents a tab running on a renderer process.
• The title of the task.

Methods

getProcessIdForTab()

chrome.processes.getProcessIdForTab(
  tabId: number,
): Promise

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

Parameters

• The ID of the tab for which the renderer process ID is to be returned.

Returns

getProcessInfo()

chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
): 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.
• True if detailed memory usage is required. Note, collecting memory usage information incurs extra CPU usage and should only be queried for when needed.

Returns

terminate()

chrome.processes.terminate(
  processId: number,
): Promise

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

Parameters

• The ID of the process to be terminated.

Returns

Events

onCreated

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

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

Parameters

• The callback parameter looks like:
  (process: Process) =& gt;void

onExited

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

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

Parameters

• The callback parameter looks like:
  (processId: number, exitType: number, exitCode: number) =& gt;void

onUnresponsive

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

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

Parameters

• The callback parameter looks like:
  (process: Process) =& gt;void

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

• The callback parameter looks like:
  (processes: object) =& gt;void

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

• The callback parameter looks like:
  (processes: object) =& gt;void

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-11 UTC.