The name
property of the PerformanceEntry
interface returns a value that further specifies the value returned by the PerformanceEntry.entryType
property. This property is read only.
Syntax
var name = entry.name;
Return value
The return value depends on the subtype of the PerformanceEntry
object and the value of PerformanceEntry.entryType
, as shown by the table below.
Value | Subtype | entryType values | Description |
---|---|---|---|
URL |
PerformanceFrameTiming , PerformanceNavigationTiming |
frame , navigation |
The document's address. |
URL |
PerformanceResourceTiming |
resource |
The resolved URL of the requested resource. This value doesn't change even if the request is redirected. |
DOMString |
PerformanceMark |
mark |
The name used when the mark was created by calling performance.mark() . |
DOMString |
PerformanceMeasure |
measure |
name used when the measure was created by calling performance.measure() . |
DOMString |
PerformancePaintTiming |
paint |
Either 'first-paint' or 'first-contentful-paint' . |
Example
The following example shows the use of the name
property.
function run_PerformanceEntry() { log("PerformanceEntry support ..."); 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"); // 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]); } } function check_PerformanceEntry(obj) { var properties = ["name", "entryType", "startTime", "duration"]; var methods = ["toJSON"]; for (var i=0; i < properties.length; i++) { // check each property var supported = properties[i] in obj; if (supported) log("..." + properties[i] + " = " + obj[properties[i]]); else log("..." + properties[i] + " = Not supported"); } for (var i=0; i < methods.length; i++) { // check each method var supported = typeof obj[methods[i]] == "function"; if (supported) { var js = obj[methods[i]](); log("..." + methods[i] + "() = " + JSON.stringify(js)); } else { log("..." + methods[i] + " = Not supported"); } } }
Specifications
Specification | Status | Comment |
---|---|---|
Performance Timeline Time Level 2 The definition of 'name' in that specification. |
Editor's Draft | |
Performance Timeline The definition of 'name' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support. | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | No support |
Feature | Android | Edge | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support. | (Yes) | (Yes) | 25.0 (25.0) | 1.2 (25.0) | 10.0 | (Yes) | No support |