chrome.processes

说明

使用 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

    数字可选

    对进程私有内存用量的最近测量值（以字节为单位）。仅在从 onUpdatedWithMemory 或带有 includeMemory 标志的 getProcessInfo 的回调中接收对象时，才可用。

  • 个人资料

    string

    与进程关联的配置文件。

  • scriptCache

    缓存（可选）

    有关进程的脚本缓存的最新信息。仅在从 onUpdated 或 onUpdatedWithMemory 回调中接收对象时，才可用。

  • sqliteMemory

    数字可选

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

  • tasks

    TaskInfo[]

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

  • 类型

    ProcessType

    进程类型。

ProcessType

浏览器进程的类型。

枚举

"renderer"

"plugin"

"worker"

"nacl"

"service_worker"

"gpu"

TaskInfo

属性

  • tabId

    数字可选

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

  • title

    string

    任务的标题。

方法

getProcessIdForTab()

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

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

参数

  • tabId

    number

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

  • callback

    函数（可选）

    callback 参数如下所示：

    (processId: number)=>void

    • processId

      number

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

返回

  • Promise<数字>

    Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。

getProcessInfo()

Promise 
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，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。

terminate()

Promise 
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，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。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

    • exitCode

      number

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

    • 进程

      对象