Performance:getEntriesByType() 方法
注意:此功能在 Web Workers 中可用。
getEntriesByType() 方法会返回性能时间线上当前存在的、给定类型的 PerformanceEntry 对象数组。
如果您对特定名称的性能条目感兴趣,请参阅 getEntriesByName()。要获取所有性能条目,请参阅 getEntries()。
注意:此方法不会通知您新的性能条目;您只会获得在调用此方法时性能时间轴中存在的条目。要接收有关可用条目的通知,请使用 PerformanceObserver。
以下条目类型完全不受此方法支持,即使可能存在这些类型的条目也不会返回
"element"(PerformanceElementTiming)"event"(PerformanceEventTiming)"largest-contentful-paint"(LargestContentfulPaint)"layout-shift"(LayoutShift)"longtask"(PerformanceLongTaskTiming)
要访问这些类型的条目,您必须改用 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 |
浏览器兼容性
加载中…