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 |
瀏覽器相容性
載入中…