chrome.processes

说明

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

权限

processes

可用性

<ph type="x-smartling-placeholder"></ph> 开发者版

类型

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

    进程的类型。

ProcessType

浏览器进程的类型。

枚举

“浏览器”

&quot;renderer&quot;

“extension”

“通知”

"插件"

"worker"

“nacl”

“service_worker”

"实用程序"

“gpu”

“其他”

TaskInfo

属性

  • tabId

    编号（选填）

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

  • 标题

    字符串

    任务的标题。

方法

getProcessIdForTab()

<ph type="x-smartling-placeholder"></ph> 承诺 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

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

参数

  • tabId

    number

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

  • callback

    函数（可选）

    callback 参数如下所示： 

    (processId: number) => void

    • processId

      number

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

返回

  • Promise&lt;number&gt;

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

getProcessInfo()

<ph type="x-smartling-placeholder"></ph> 承诺 
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&lt;object&gt;

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

terminate()

<ph type="x-smartling-placeholder"></ph> 承诺 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

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

参数

  • processId

    number

    要终止的进程的 ID。

  • callback

    函数（可选）

    callback 参数如下所示： 

    (didTerminate: boolean) => void

    • didTerminate

      布尔值

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

返回

  • Promise&lt;boolean&gt;

    只有 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

      number

    • exitType

      number

    • 退出代码

      number

onUnresponsive

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

每当进程无响应时触发，并提供相应的 Process 对象。

参数

  • callback

    函数

    callback 参数如下所示： 

    (process: Process) => void

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

    • 进程

      对象