大网数据广告活动
Web 标准与前端开发

PerformanceLongTaskTiming

· 52CE 我爱测

`PerformanceLongTaskTiming`** 接口提供了关于占用 UI 线程 50 毫秒或更长时间的任务的信息。

Performance API

PerformanceLongTaskTiming 接口提供了关于占用 UI 线程 50 毫秒或更长时间的任务的信息。

描述

会阻塞主线程 50 毫秒或更长时间的长任务会导致以下问题(除其他问题外):

  • Time to interactive延迟。
  • 严重不稳定的输入延迟。
  • 严重不稳定的事件回调延迟。
  • 卡顿的动画和活动效果。

长任务是指主 UI 线程连续忙碌 50 毫秒或更长时间的任何不间断时段。常见示例包括:

  • 长时间运行的事件处理程序。
  • 耗时的布局重排和其他重渲染操作。
  • 浏览器在事件循环的不同轮次之间执行的、耗时超过 50 毫秒的操作。

长任务所指的“引发问题的浏览上下文容器”(简称“容器”),即任务发生所在的顶级页面、iframe、embed 或 object。

对于未发生在顶级页面内的任务,以及为了确定哪个容器导致了该长时间任务,TaskAttributionTiming 接口提供了 containerId、containerName 和 containerSrc 属性,这些属性可能提供有关任务来源的更多信息。

PerformanceLongTaskTiming 继承自 PerformanceEntry。

实例属性

该接口通过以下限定方式,扩展了以下适用于长任务计时性能条目类型的 PerformanceEntry 属性:

  • PerformanceEntry.duration
    • : 返回一个 DOMHighResTimeStamp,表示任务开始到结束之间的经过时间,精度为 1 毫秒。
  • PerformanceEntry.entryType
    • : 始终返回 "longtask"
  • PerformanceEntry.name
    • : 返回以下字符串之一,指代可归因于该长任务的浏览上下文或框架:
      • "cross-origin-ancestor"
      • "cross-origin-descendant"
      • "cross-origin-unreachable"
      • "multiple-contexts"
      • "same-origin-ancestor"
      • "same-origin-descendant"
      • "same-origin"
      • "self"
      • "unknown"
  • PerformanceEntry.startTime
    • : 返回一个 DOMHighResTimeStamp,表示任务开始的时间。

该接口还支持以下属性:

  • PerformanceLongTaskTiming.attribution
    • : 返回一个 TaskAttributionTiming 实例序列。

实例方法

  • PerformanceLongTaskTiming.toJSON()
    • : 重写 PerformanceEntry.toJSON() 方法,以返回 PerformanceLongTaskTiming 对象的 JSON 表示。

示例

获取长任务

要获取长任务的计时信息,请创建一个 PerformanceObserver 实例,然后调用其 observe() 方法,并将 "longtask" 作为 type 选项的值。此外,还需要将 buffered 设置为 true,以便获取用户代理在构建文档时缓冲的长时间任务。随后,PerformanceObserver 对象的回调函数将被调用,并传入一个包含 PerformanceLongTaskTiming 对象的列表,你可以对这些对象进行分析。

const observer = new PerformanceObserver((list) => {
  list.getEntries().forEach((entry) => {
    console.log(entry);
  });
});

observer.observe({ type: "longtask", buffered: true });

规范

浏览器兼容性

参见

  • TaskAttributionTiming

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。