The getEntriesByName()
method returns a list of PerformanceEntry
objects for the given name and type. The list's members (entries) can be created by making performance marks or measures (for example by calling the mark()
method) at explicit points in time.
Note: This feature is available in Web Workers.
Syntax
entries = window.performance.getEntriesByName(name, type);
Arguments
- name
- The name of the entry to retrieve.
- type Optional
- 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 | Status | Comment |
Performance Timeline Level 2The definition of 'getEntriesByName()' in that specification. | Candidate Recommendation | |
Performance TimelineThe definition of 'getEntriesByName()' in that specification. | Recommendation | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getEntriesByName
|
Chrome Full support 28 Full support 28 No support 25 — 36 Prefixed' Implemented with the vendor prefix: webkit |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
Full support Yes |
Opera
No support No |
Safari
Full support 11 |
WebView Android
Full support Yes |
Chrome Android Full support 28 Full support 28 No support 25 — 36 Prefixed' Implemented with the vendor prefix: webkit |
Firefox Android
Full support 25 |
Opera Android
No support No |
Safari iOS
Full support 11 |
Samsung Internet Android Full support 1.5 Full support 1.5 No support 1.5 — 3.0 Prefixed' Implemented with the vendor prefix: webkit |
Legend
- Full support
- Full support
- No support
- No support
- Requires a vendor prefix or different name for use.'
- Requires a vendor prefix or different name for use.
performance.getEntriesByName() by Mozilla Contributors is licensed under CC-BY-SA 2.5.