说明
使用 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 进程,为零。
-
网络
编号(选填)
对进程网络使用情况的最新测量结果,以每秒字节数为单位。仅当作为 onUpdated 或 onUpdatedWithMemory 的回调的一部分接收对象时,此字段才可用。
-
osProcessId
number
进程的 ID,由操作系统提供。
-
privateMemory
编号(选填)
最近测量的进程专用内存使用情况(以字节为单位)。仅当对象是作为具有 includeMemory 标志的 onUpdatedWithMemory 或 getProcessInfo 回调的一部分时,此字段才可用。
-
个人资料
字符串
与进程相关联的配置文件。
-
scriptCache
缓存(可选)
有关进程脚本缓存的最新信息。仅当作为 onUpdated 或 onUpdatedWithMemory 的回调的一部分接收对象时,此字段才可用。
-
sqliteMemory
编号(选填)
最近测量的进程的 SQLite 内存使用情况(以字节为单位)。仅当作为 onUpdated 或 onUpdatedWithMemory 的回调的一部分接收对象时,此字段才可用。
-
任务
TaskInfo[]
表示在此进程中运行的任务的 TaskInfo 数组。
-
类型
进程的类型。
ProcessType
浏览器进程的类型。
枚举
“浏览器”
"renderer"
“extension”
“通知”
"插件"
"worker"
“nacl”
“service_worker”
"实用程序"
“gpu”
“其他”
TaskInfo
属性
-
tabId
编号(选填)
(可选)标签页 ID(如果此任务表示在渲染程序进程中运行的标签页)。
-
标题
字符串
任务的标题。
方法
getProcessIdForTab()
chrome.processes.getProcessIdForTab(
tabId: number,
callback?: function,
)
返回指定标签页的渲染程序进程的 ID。
参数
-
tabId
number
要返回其渲染程序进程 ID 的标签页的 ID。
-
callback
函数(可选)
callback
参数如下所示:(processId: number) => void
-
processId
number
标签页的渲染程序进程的进程 ID。
-
返回
-
Promise<number>
Manifest V3 及更高版本支持 Promise,但为以下项目提供回调: 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。
getProcessInfo()
chrome.processes.getProcessInfo(
processIds: number | number[],
includeMemory: boolean,
callback?: function,
)
检索指定的每个进程 ID 的进程信息。
参数
-
processIds
数字 |数值 []
要为其返回进程信息的进程 ID 或单个进程 ID 的列表。空列表表示请求了所有进程。
-
includeMemory
布尔值
如果需要详细内存用量,则为 true。请注意,收集内存使用情况信息会产生额外的 CPU 占用,因此只应在需要时查询。
-
callback
函数(可选)
callback
参数如下所示:(processes: object) => void
-
进程
对象
每个请求的进程(当前浏览器进程的活跃子进程)的
Process
对象字典,按进程 ID 编入索引。需要随时间进行汇总的指标不会填充到每个 Process 对象中。
-
返回
-
Promise<object>
Manifest V3 及更高版本支持 Promise,但为以下项目提供回调: 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。
terminate()
chrome.processes.terminate(
processId: number,
callback?: function,
)
终止指定的渲染程序进程。相当于访问 about:crash,但无需更改标签页的网址。
参数
-
processId
number
要终止的进程的 ID。
-
callback
函数(可选)
callback
参数如下所示:(didTerminate: boolean) => void
-
didTerminate
布尔值
如果成功终止进程,则为 true,否则为 false。
-
返回
-
Promise<boolean>
Manifest V3 及更高版本支持 Promise,但为以下项目提供回调: 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 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
-
退出代码
number
-
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
-
进程
对象
-