Skip to main content

TraceConfig 对象

🌐 TraceConfig Object

  • recording_mode 字符串（可选）- 可以是 record-until-full、record-continuously、record-as-much-as-possible 或 trace-to-console。默认值为 record-until-full。
  • trace_buffer_size_in_kb 数字（可选）- 跟踪记录缓冲区的最大大小，单位为千字节。默认值为 100MB。
  • trace_buffer_size_in_events 数字（可选）- 跟踪记录缓冲区中事件的最大大小。
  • enable_argument_filter 布尔值（可选）- 如果为 true，则根据经过人工审核、未包含任何个人身份信息（PII）的特定事件列表过滤事件数据。具体请参见 在 Chromium 中的实现。
  • included_categories string[]（可选）- 包含的跟踪类别列表。类别名称末尾可以使用 * 来匹配类似通配符的模式。有关类别列表，请参见 追踪类别。
  • excluded_categories string[]（可选）- 要排除的跟踪类别列表。可以在类别名称末尾使用 * 来包含类似通配符的模式。有关类别列表，请参见 追踪类别。
  • included_process_ids number[]（可选）- 要包含在跟踪中的进程 ID 列表。如果未指定，则跟踪所有进程。
  • histogram_names string[]（可选）- 要随跟踪报告的 直方图 名称列表。
  • 'memory_dump_config' 记录<string, any> （可选）——如果启用了“disabled-by-default-memory-infra”类别，则包含可选的额外数据收集配置。更多信息请参见Chromium 内存基础文档条目。

一个大致与 Chrome DevTools 记录相匹配的 TraceConfig 示例：

🌐 An example TraceConfig that roughly matches what Chrome DevTools records:

{
  recording_mode: 'record-until-full',
  included_categories: [
    'devtools.timeline',
    'disabled-by-default-devtools.timeline',
    'disabled-by-default-devtools.timeline.frame',
    'disabled-by-default-devtools.timeline.stack',
    'v8.execute',
    'blink.console',
    'blink.user_timing',
    'latencyInfo',
    'disabled-by-default-v8.cpu_profiler',
    'disabled-by-default-v8.cpu_profiler.hires'
  ],
  excluded_categories: ['*']
}