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.
Note: This feature is available in Web Workers.
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 Level 2The definition of 'name' in that specification. | Candidate Recommendation | |
Performance TimelineThe definition of 'name' 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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
name
|
Chrome
Full support Yes |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
Full support Yes |
Opera
Full support Yes |
Safari
Full support 11 |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support 25 |
Opera Android
Full support Yes |
Safari iOS
Full support 11 |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
PerformanceEntry.name by Mozilla Contributors is licensed under CC-BY-SA 2.5.