performance.getEntriesByName()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
**getEntriesByName()
**方法返回一个给定名称和 name 和 type 属性的PerformanceEntry
对象数组。在创建 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 inPerformanceEntry.entryType
.
Return value
- entries
-
A list of
PerformanceEntry
objects that have the specifiedname
andtype
. If thetype
argument is not specified, only thename
will be used to determine the entries to return. The items will be in chronological order based on the entries'startTime
. If no objects meet the specified criteria, an empty list is returned.
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
Specification |
---|
Performance Timeline # dom-performance-getentriesbyname |
Browser compatibility
BCD tables only load in the browser