跳转到主要内容

contentTracing

收集 Chromium 的跟踪数据，以查找性能瓶颈和慢速操作。

进程：主进程

此模块不包含 Web 界面。要查看记录的跟踪，请使用 trace viewer，可在 Chrome 的 chrome://tracing 中找到。

注意

在发出 app 模块的 ready 事件之前，您不应使用此模块。

const { app, contentTracing } = require('electron')

app.whenReady().then(() => {
  (async () => {
    await contentTracing.startRecording({
      included_categories: ['*']
    })
    console.log('Tracing started')
    await new Promise(resolve => setTimeout(resolve, 5000))
    const path = await contentTracing.stopRecording()
    console.log('Tracing data recorded to ' + path)
  })()
})

方法​

contentTracing 模块具有以下方法：

contentTracing.getCategories()​

返回 Promise<string[]> - 在所有子进程确认 getCategories 请求后，解析为一个类别组数组。

获取一组类别组。类别组可能会随着新的代码路径被触及而改变。另请参阅 内置跟踪类别列表。

注意： Electron 添加了一个非默认的跟踪类别，称为 "electron"。此类别可用于捕获 Electron 特定的跟踪事件。

contentTracing.startRecording(options)​

返回 Promise<void> - 在所有子进程确认 startRecording 请求后解析。

在所有进程上开始录制。

录制会立即在本地开始，并在子进程接收到 EnableRecording 请求后异步开始。

如果已有一个录制正在进行，则 Promise 会立即解析，因为一次只能进行一个跟踪操作。

contentTracing.stopRecording([resultFilePath])​

  • resultFilePath string (可选)

返回 Promise<string> - 在所有子进程确认 stopRecording 请求后，解析为包含跟踪数据的文件路径。

停止所有进程上的录制。

子进程通常会缓存跟踪数据，很少刷新并将跟踪数据发送回主进程。这有助于最大程度地减少跟踪的运行时开销，因为通过 IPC 发送跟踪数据可能是一项昂贵的操作。因此，为了结束跟踪，Chromium 会异步请求所有子进程刷新任何待处理的跟踪数据。

跟踪数据将写入 resultFilePath。如果 resultFilePath 为空或未提供，跟踪数据将写入临时文件，并且该路径将在 Promise 中返回。

contentTracing.getTraceBufferUsage()​

返回 Promise<Object> - 解析为一个对象，其中包含跟踪缓冲区最大使用量的 value 和 percentage。

  • value number
  • percentage number

获取所有进程的跟踪缓冲区最大使用量（占满状态的百分比）。