chrome.processes

说明

使用 chrome.processes API 与浏览器的进程交互。

权限

processes

可用性

开发者渠道

类型

Cache

属性

  • liveSize

    数值

    已使用的缓存部分（以字节为单位）。

  • size

    数值

    缓存的大小（以字节为单位）。

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 进程，此值为零。

  • 网络

    number 可选

    进程网络使用情况的最新测量值，以每秒字节数为单位。仅当通过 onUpdated 或 onUpdatedWithMemory 回调接收对象时可用。

  • osProcessId

    数值

    进程的 ID（由操作系统提供）。

  • privateMemory

    number 可选

    进程私有内存用量的最新测量值（以字节为单位）。仅当通过 onUpdatedWithMemory 回调或 getProcessInfo（包含 includeMemory 标志）接收对象时可用。

  • 个人资料

    字符串

    与进程关联的配置文件。

  • scriptCache

    缓存（可选）

    有关进程脚本缓存的最新信息。仅当通过 onUpdated 或 onUpdatedWithMemory 回调接收对象时可用。

  • sqliteMemory

    number 可选

    进程 SQLite 内存用量的最新测量值（以字节为单位）。仅当通过 onUpdated 或 onUpdatedWithMemory 回调接收对象时可用。

  • 任务

    TaskInfo[]

    表示在此进程中运行的任务的 TaskInfo 数组。

  • 类型

    ProcessType

    进程的类型。

ProcessType

浏览器进程的类型。

枚举

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"

"nacl"

"service_worker"
已废弃，永远不会返回。

"utility"

“gpu”

“other”

TaskInfo

属性

  • tabId

    number 可选

    可选的标签页 ID（如果此任务代表在渲染程序进程中运行的标签页）。

  • title

    字符串

    任务的标题。

方法

getProcessIdForTab()

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

返回指定标签页的渲染程序进程的 ID。

参数

  • tabId

    数值

    要为其返回渲染程序进程 ID 的标签页的 ID。

  • callback

    函数（可选）

    callback 参数如下所示： 

    (processId: number) => void

    • processId

      数值

      标签页的渲染程序进程的进程 ID。

返回

  • Promise<number>

    只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getProcessInfo()

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

检索指定的每个进程 ID 的进程信息。

参数

  • processIds

    number | number[]

    要为其返回进程信息的进程 ID 列表或单个进程 ID。空列表表示请求了所有进程。

  • includeMemory

    布尔值

    如果需要详细的内存用量信息，则为 true。请注意，收集内存用量信息会增加 CPU 用量，因此请仅在需要时查询。

  • callback

    函数（可选）

    callback 参数如下所示： 

    (processes: object) => void

    • 进程

      对象

      一个 Process 对象字典，用于表示每个请求的进程（即当前浏览器进程的实时子进程），按进程 ID 编入索引。不需要按时间进行汇总的指标不会填充到每个 Process 对象中。

返回

  • Promise<object>

    只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

terminate()

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

终止指定的渲染程序。相当于访问 about:crash，但不会更改标签页的网址。

参数

  • processId

    数值

    要终止的进程的 ID。

  • callback

    函数（可选）

    callback 参数如下所示： 

    (didTerminate: boolean) => void

    • didTerminate

      布尔值

      如果终止进程成功，则为 true，否则为 false。

返回

  • Promise<boolean>

    只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

事件

onCreated

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

每次创建进程时都会触发，并提供相应的 Process 对象。

参数

  • callback

    函数

    callback 参数如下所示： 

    (process: Process) => void

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 对象。

参数

  • callback

    函数

    callback 参数如下所示： 

    (process: Process) => void

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

    • 进程

      对象