Performance API
**getEntriesByName()**方法返回一个给定名称和 name 和 type 属性的PerformanceEntry对象数组。在创建 performance 标记或在明确的时间点测量(比如手动调用Performance.mark方法)也可以创建这样的对象数组。
在 Workers 中可以使用该方法。
语法
entries = window.performance.getEntriesByName(name, type);
参数
- name
- : The name of the entry to retrieve.
- type
- : The type of entry to retrieve such as "
mark". The valid entry types are listed in PerformanceEntry.entryType.
- : The type of entry to retrieve such as "
Return value
- entries
- : A list of PerformanceEntry objects that have the specified
nameandtype. If thetypeargument is not specified, only thenamewill be used to determine the entries to return. The items will be in chronological order based on the entries' PerformanceEntry.startTime. If no objects meet the specified criteria, an empty list is returned.
- : A list of PerformanceEntry objects that have the specified
Example
function use_PerformanceEntry_methods() {
log("PerformanceEntry tests ...");
if (performance.mark === undefined) {
log("... performance.mark Not supported");
return;
}
// Create some performance entries via the mark() method
performance.mark("Begin");
do_work(50000);
performance.mark("End");
performance.mark("Begin");
do_work(100000);
performance.mark("End");
do_work(200000);
performance.mark("End");
// Use getEntries() to iterate through the each entry
var p = performance.getEntries();
for (var i = 0; i < p.length; i++) {
log("Entry[" + i + "]");
check_PerformanceEntry(p[i]);
}
// Use getEntries(name, entryType) to get specific entries
p = performance.getEntries({ name: "Begin", entryType: "mark" });
for (var i = 0; i < p.length; i++) {
log("Begin[" + i + "]");
check_PerformanceEntry(p[i]);
}
// Use getEntriesByType() to get all "mark" entries
p = performance.getEntriesByType("mark");
for (var i = 0; i < p.length; i++) {
log(
"Mark only entry[" +
i +
"]: name = " +
p[i].name +
"; startTime = " +
p[i].startTime +
"; duration = " +
p[i].duration,
);
}
// Use getEntriesByName() to get all "mark" entries named "Begin"
p = performance.getEntriesByName("Begin", "mark");
for (var i = 0; i < p.length; i++) {
log(
"Mark and Begin entry[" +
i +
"]: name = " +
p[i].name +
"; startTime = " +
p[i].startTime +
"; duration = " +
p[i].duration,
);
}
}
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
