Performance:getEntriesByType() 方法

Baseline 已广泛支持

此功能已成熟,可跨多种设备和浏览器版本使用。自 2017 年 9 月以来,它已在浏览器中提供。

注意:此功能在 Web Workers 中可用。

getEntriesByType() 方法会返回性能时间线上当前存在的、给定类型PerformanceEntry 对象数组。

如果您对特定名称的性能条目感兴趣,请参阅 getEntriesByName()。要获取所有性能条目,请参阅 getEntries()

注意:此方法不会通知您新的性能条目;您只会获得在调用此方法时性能时间轴中存在的条目。要接收有关可用条目的通知,请使用 PerformanceObserver

以下条目类型完全不受此方法支持,即使可能存在这些类型的条目也不会返回

要访问这些类型的条目,您必须改用 PerformanceObserver

语法

js
getEntriesByType(type)

参数

type

要检索的条目类型,例如 "mark"。有效的条目类型列在 PerformanceEntry.entryType 中。支持的 entryTypes 可以使用静态属性 PerformanceObserver.supportedEntryTypes 进行检索。

返回值

一个 PerformanceEntry 对象数组,这些对象的 type 与指定的类型匹配。这些条目将根据条目的 startTime 按时间顺序排列。如果没有具有指定 type 的对象,或者未提供参数,则返回一个空数组。

示例

记录资源条目

以下示例记录所有类型为 "resource" 的条目。

js
const resources = performance.getEntriesByType("resource");
resources.forEach((entry) => {
  console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});

规范

规范
性能时间线
# dom-performance-getentriesbytype

浏览器兼容性

另见