Performance.getEntriesByType()
The getEntriesByType()
method returns a list of PerformanceEntry
objects for a given 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.
This method is exposed to Window
and Worker
interfaces.
Syntax
JavaScript
Copy Code
entries = window.performance.getEntriesByType(type);
Arguments
- 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 specifiedtype
. The items will be in chronological order based on the entries'startTime
. If no objects have the specifiedtype
, or no argument is provided, an empty list is returned.
Example
JavaScript
Copy Code
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 Time Level 2 The definition of 'getEntriesByType()' in that specification. |
Editor's Draft | |
Performance Timeline The definition of 'getEntriesByType()' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support. | (Yes) | (Yes) | (Yes) | No support | No support |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support. | No support | (Yes) | 25.0 (25.0) | 1.2 (25.0) | 10.0 | No support | No support | (Yes) |
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/performance/getentriesbytype