说明
使用 chrome.processes
API 与浏览器的进程进行交互。
权限
processes
可用性
类型
Cache
属性
-
liveSize
number
使用的缓存部分(以字节为单位)。
-
大小
number
缓存的大小(以字节为单位)。
Process
属性
-
cpu
数字可选
进程的 CPU 使用率的最新测量值,表示为进程的所有线程使用的单个 CPU 核心总数的百分比。这会提供一个介于 0 到 CpuInfo.numOfProcessors*100 之间的值,在多线程进程中,该值可以超过 100%。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时,才可用。
-
cssCache
缓存(可选)
有关进程的 CSS 缓存的最新信息。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时,才可用。
-
id
number
浏览器提供的进程的唯一 ID。
-
imageCache
缓存(可选)
进程的图片缓存的最新信息。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时,才可用。
-
jsMemoryAllocated
数字可选
对进程 JavaScript 分配的内存的最近测量(以字节为单位)。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时,才可用。
-
jsMemoryUsed
数字可选
对已用进程 JavaScript 内存的最近测量值(以字节为单位)。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时,才可用。
-
naclDebugPort
number
Native Client 进程的调试端口。对于其他进程类型和未启用调试的 NaCl 进程,该值为零。
-
您的VPC网络与本地网络之间的网络连接
数字可选
对进程网络使用情况的最新测量结果(以每秒字节数为单位)。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时,才可用。
-
osProcessId
number
进程的 ID,由操作系统提供。
-
privateMemory
数字可选
对进程私有内存用量的最近测量值(以字节为单位)。仅在从 onUpdatedWithMemory 或带有 includeMemory 标志的 getProcessInfo 的回调中接收对象时,才可用。
-
个人资料
string
与进程关联的配置文件。
-
scriptCache
缓存(可选)
有关进程的脚本缓存的最新信息。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时,才可用。
-
sqliteMemory
数字可选
对进程的 SQLite 内存用量的最新测量值(以字节为单位)。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时,才可用。
-
tasks
TaskInfo[]
TaskInfo 数组,表示在此进程上运行的任务。
-
类型
进程类型。
ProcessType
浏览器进程的类型。
枚举
"renderer"
"plugin"
"worker"
"nacl"
"service_worker"
"gpu"
TaskInfo
属性
-
tabId
数字可选
可选标签页 ID(如果此任务表示在渲染程序进程上运行的标签页)。
-
title
string
任务的标题。
方法
getProcessIdForTab()
chrome.processes.getProcessIdForTab(
tabId: number,
callback?: function,
)
返回指定标签页的渲染程序进程的 ID。
参数
-
tabId
number
要返回其渲染程序进程 ID 的标签页的 ID。
-
callback
函数(可选)
callback
参数如下所示:(processId: number) => void
-
processId
number
标签页的渲染程序进程的进程 ID。
-
返回
-
Promise<数字>
只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
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>
只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
terminate()
chrome.processes.terminate(
processId: number,
callback?: function,
)
终止指定的渲染器进程。相当于访问 about:crash,但不更改标签页的网址。
参数
-
processId
number
要终止的进程的 ID。
-
callback
函数(可选)
callback
参数如下所示:(didTerminate: boolean) => void
-
didTerminate
boolean
如果终止进程成功,则为 true,否则为 false。
-
返回
-
Promise<boolean>
只有 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
活动
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
number
-
exitType
number
-
exitCode
number
-
onUnresponsive
chrome.processes.onUnresponsive.addListener(
callback: function,
)
每当进程无响应时触发,并提供相应的 Process 对象。
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
-
进程
对象
-