Performance: getEntriesByName() 方法
注意：此功能在 Web Workers 中可用。
getEntriesByName() 方法返回一个由当前性能时间轴中具有给定名称和类型的 PerformanceEntry 对象组成的数组。
如果您对特定类型的性能条目感兴趣，请参阅 getEntriesByType()。有关所有性能条目，请参阅 getEntries()。
注意：此方法不会通知您新的性能条目；您只会获得在调用此方法时性能时间轴中存在的条目。要接收有关可用条目的通知，请使用 PerformanceObserver。
以下条目类型完全不受此方法支持，即使可能存在这些类型的条目也不会返回
"element"(PerformanceElementTiming)"event"(PerformanceEventTiming)"largest-contentful-paint"(LargestContentfulPaint)"layout-shift"(LayoutShift)"longtask"(PerformanceLongTaskTiming)
要访问这些类型的条目，您必须改用 PerformanceObserver。
语法
js
getEntriesByName(name)
getEntriesByName(name, type)
参数
name-
要检索的条目的名称。
type可选-
要检索的条目类型，例如
"mark"。有效的条目类型列在PerformanceEntry.entryType中。
返回值
一个 Array，其中包含具有指定 name 和 type 的 PerformanceEntry 对象。条目将按其 startTime 的时间顺序排列。如果没有对象满足指定标准，则返回一个空数组。
示例
记录性能标记
以下示例记录所有名为 "debug-mark" 的 PerformanceMark 对象。
js
const debugMarks = performance.getEntriesByName("debug-mark", "mark");
debugMarks.forEach((entry) => {
console.log(`${entry.name}'s startTime: ${entry.startTime}`);
});
规范
| 规范 |
|---|
| 性能时间线 # dom-performance-getentriesbyname |
浏览器兼容性
加载中…