chrome.processes

Description

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

Permissions

processes

Availability

Dev channel

Summary

Types

Cache

PROPERTIES

  • liveSize

    number

    使用的缓存部分，以字节为单位。

  • size

    number

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

Process

PROPERTIES

  • cpu

    number optional

    进程 CPU 使用率的最新测量值，表示为进程所有线程使用的单个 CPU 内核总数的百分比。这给出了一个从零到 CpuInfo.numOfProcessors*100 的值，在多线程进程中可以超过 100%。仅当从 onUpdated 或 onUpdatedWithMemory 接收对象作为回调的一部分时可用。

  • cssCache

    Cache optional

    有关进程的 CSS 缓存的最新信息。仅当从 onUpdated 或 onUpdatedWithMemory 接收对象作为回调的一部分时可用。

  • id

    number

    浏览器提供的进程的唯一 ID。

  • imageCache

    Cache optional

    有关进程图像缓存的最新信息。仅当从 onUpdated 或 onUpdatedWithMemory 接收对象作为回调的一部分时可用。

  • jsMemoryAllocated

    number optional

    进程 JavaScript 分配的内存的最新度量，以字节为单位。仅当从 onUpdated 或 onUpdatedWithMemory 接收对象作为回调的一部分时可用。

  • jsMemoryUsed

    number optional

    使用的进程 JavaScript 内存的最新测量值，以字节为单位。仅当从 onUpdated 或 onUpdatedWithMemory 接收对象作为回调的一部分时可用。

  • naclDebugPort

    number

    本机客户端进程的调试端口。其他进程类型和未启用调试的 NaCl 进程为零。

  • network

    number optional

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

  • osProcessId

    number

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

  • privateMemory

    number optional

    进程私有内存使用量的最新测量值，以字节为单位。仅当从 onUpdatedWithMemory 或 getProcessInfo 使用 includeMemory 标志接收对象作为回调的一部分时可用。

  • profile

    string

    与进程关联的配置文件。

  • scriptCache

    Cache optional

    有关进程脚本缓存的最新信息。仅当从 onUpdated 或 onUpdatedWithMemory 接收对象作为回调的一部分时可用。

  • sqliteMemory

    number optional

    进程的 SQLite 内存使用量的最新测量值，以字节为单位。仅当从 onUpdated 或 onUpdatedWithMemory 接收对象作为回调的一部分时可用。

  • tasks

    TaskInfo[]

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

  • type

    ProcessType

    进程的类型。

ProcessType

浏览器进程的类型。

TYPE

"browser", "renderer", "extension", "notification", "plugin", "worker", "nacl", "service_worker", "utility", "gpu", or "other"

TaskInfo

PROPERTIES

  • tabId

    number optional

    可选选项卡 ID，如果此任务表示在渲染器进程上运行的选项卡。

  • title

    string

    任务的标题。

Methods

getProcessIdForTab 

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

Promise

返回指定选项卡的渲染器进程的 ID。

PARAMETERS

  • tabId

    number

    要为其返回渲染器进程 ID 的选项卡的 ID。

  • callback

    function optional

    The callback parameter looks like:

    (processId: number) => void

    • processId

      number

      选项卡渲染器进程的进程 ID。

RETURNS

  • Promise<number>

    这仅在未指定回调参数时返回 Promise，并且使用 MV3+。 Promise 中的类型与回调的第一个参数相同。

getProcessInfo 

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

Promise

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

PARAMETERS

  • processIds

    number | number[]

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

  • includeMemory

    boolean

    如果需要详细的内存使用情况，则为 True。请注意，收集内存使用信息会导致额外的 CPU 使用率，因此应仅在需要时进行查询。

  • callback

    function optional

    The callback parameter looks like:

    (processes: object) => void

    • processes

      object

      每个请求进程的 Process 对象字典，它是当前浏览器进程的活动子进程，按进程 ID 索引。不会在每个 Process 对象中填充需要随时间聚合的指标。

RETURNS

  • Promise<object>

    这仅在未指定回调参数时返回 Promise，并且使用 MV3+。 Promise 中的类型与回调的第一个参数相同。

terminate 

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

Promise

终止指定的渲染器进程。相当于访问 about:crash，但不更改选项卡的 URL。

PARAMETERS

  • processId

    number

    要终止的进程的 ID。

  • callback

    function optional

    The callback parameter looks like:

    (didTerminate: boolean) => void

    • didTerminate

      boolean

      如果终止进程成功则为真，否则为假。

RETURNS

  • Promise<boolean>

    这仅在未指定回调参数时返回 Promise，并且使用 MV3+。 Promise 中的类型与回调的第一个参数相同。

Events

onCreated 

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

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

PARAMETERS

  • callback

    function

    The callback parameter looks like:

    (process: Process) => void

onExited 

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

每次进程终止时触发，提供退出类型。

PARAMETERS

  • callback

    function

    The callback parameter looks like:

    (processId: number, exitType: number, exitCode: number) => void

    • processId

      number

    • exitType

      number

    • exitCode

      number

onUnresponsive 

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

每次进程变得无响应时触发，提供相应的 Process 对象。

PARAMETERS

  • callback

    function

    The callback parameter looks like:

    (process: Process) => void

onUpdated 

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

每次任务管理器更新其进程统计信息时触发，提供更新的进程对象字典，按进程 ID 索引。

PARAMETERS

  • callback

    function

    The callback parameter looks like:

    (processes: object) => void

    • processes

      object

onUpdatedWithMemory 

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

每次任务管理器更新其进程统计信息时触发，提供更新的进程对象字典，按进程 ID 索引。与 onUpdate 相同，增加了每个 Process 对象中包含的内存使用详细信息。请注意，收集内存使用信息会导致额外的 CPU 使用率，因此应仅在需要时进行侦听。

PARAMETERS

  • callback

    function

    The callback parameter looks like:

    (processes: object) => void

    • processes

      object

By.一粒技术服务.

results matching ""

    No results matching ""