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

Performance API

· 52CE 我爱测

衡量和分析各种性能指标对于确保 web 应用的速度非常重要。Performance API 提供了重要的内置指标,并能够将你自己的测量结果添加到浏览器的性能时间线(performance timeline)中。性能时间线使用高精度的时间戳,且可以在开发者工具中显示。你还可以将相关数据发送到用于分析的端点,以根据时间记录性能指标。

Performance API

Performance API 是一组用于衡量 web 应用性能的标准。

概念和用法

衡量和分析各种性能指标对于确保 web 应用的速度非常重要。Performance API 提供了重要的内置指标,并能够将你自己的测量结果添加到浏览器的性能时间线(performance timeline)中。性能时间线使用高精度的时间戳,且可以在开发者工具中显示。你还可以将相关数据发送到用于分析的端点,以根据时间记录性能指标。

每一个性能指标都使用一个性能条目(PerformanceEntry)表示。性能条目有名称(name)、持续时间(duration)、开始时间(startTime)和类型(type)。每一个性能指标都继承了 PerformanceEntry 接口,并对其进行限定。

大部分性能条目都在不需要任何额外操作的情况下进行记录,并可以通过 Performance.getEntries() 或(最好)通过 PerformanceObserver 访问。例如,PerformanceEventTiming 条目用于记录花费的时间超过设定阈值的事件。而 Performance API 也允许你使用 PerformanceMark 和 PerformanceMeasure 接口定义和记录自定义事件。

Performance 主接口在 Window.performance 和 WorkerGlobalScope.performance 全局作用域下都可用,并允许你增加自定义性能条目、清除性能条目,以及查询性能条目。

PerformanceObserver 接口允许你监听记录的不同类型的性能条目。

Performance API 的 UML 图

接口

  • EventCounts
    • : 由 performance.eventCounts 返回的只读映射,其中包含每个事件类型被分派的事件数量。
  • LargestContentfulPaint
    • : 测量视口范围内可见的图像和文本块的最大渲染时间,从页面开始加载时开始记录。
  • Performance
    • : 用于性能测量的主接口。可在 window 和 worker 上下文中通过 Window.performance 或 WorkerGlobalScope.performance 来访问。
  • PerformanceElementTiming
    • : 测量特定元素的渲染时间戳。
  • PerformanceEntry
    • : 封装了单个性能指标的性能时间线条目。所有性能指标都继承自该接口。
  • PerformanceEventTiming
    • : 测量事件的延迟和首次输入延迟(FID)。
  • PerformanceLongTaskTiming
    • : 检测占用渲染并阻止其他任务执行的长任务。
  • PerformanceMark
    • : 在性能时间线上标记自定义条目。
  • PerformanceMeasure
    • : 自定义使用两个性能条目表示的时间测量。
  • PerformanceNavigationTiming
    • : 测量文档导航事件,例如加载文档所需的时间。
  • PerformanceObserver
    • : 监听记录到性能时间线中的新的性能条目。
  • PerformanceObserverEntryList
    • : 性能观察器(PerformanceObserver)中监测的条目的列表。
  • PerformancePaintTiming
    • : 测量网页构建期间的渲染操作。
  • PerformanceResourceTiming
    • : 测量网络负载指标,例如重定向开始和结束时间、(fetch)请求开始、DNS 查询开始和结束时间,以及图像、脚本、fetch 调用,等资源的响应开始和结束时间。
  • PerformanceServerTiming
    • : 表示服务器的相关指标,在响应请求时与 Server-Timing HTTP 标头一起发送。
  • TaskAttributionTiming
    • : 标识任务类型,及用于长任务测量的容器。

教程和指南

规范

参见

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

资料来源与适用范围

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

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

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