PerformanceEntry.name - Web API 接口参考 编辑

name 是 PerformanceEntry 接口的属性，此属性的返回值是 PerformanceEntry.entryType 的返回值的一个补充，例如entry.entryType="navigation",entry.name="document". 这是一个只读属性.

Syntax

var name = entry.name;

返回值

返回值取决于PerformanceEntry 对象的 subtype和PerformanceEntry.entryType的值, 如下表所示.

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'.

用例

下面的例子是 name 属性的用法.

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]);
  }
}
  //
  //例如上面p中一个entry p[0] = {
  //  "name": "document",
  //  "entryType": "navigation",
  //  "startTime": 0,
  //  "duration": 3611.26,
  //  "initiatorType": "navigation",
  //  "nextHopProtocol": "http/1.1",
  //  "workerStart": 0,
  //  "redirectStart": 0,
  //  "redirectEnd": 0,
  //  "fetchStart": 0.32,
  //  "domainLookupStart": 17.64,
  //  "domainLookupEnd": 17.78,
  //  "connectStart": 17.86,
  //  "connectEnd": 18.1,
  //  "secureConnectionStart": 0,
  //  "requestStart": 18.3,
  //  "responseStart": 294.06,
  //  "responseEnd": 1610.3600000000001,
  //  "transferSize": 97683,
  //  "encodedBodySize": 97112,
  //  "decodedBodySize": 97112,
  //  "unloadEventStart": 1614.8372840721554,
  //  "unloadEventEnd": 1619.1600105887128,
  //  "domInteractive": 3110.767514889843,
  //  "domContentLoadedEventStart": 3125.859851800787,
  //  "domContentLoadedEventEnd": 3438.5779820633365,
  //  "domComplete": 3609.999662153349,
  //  "loadEventStart": 3610.017623620869,
  //  "loadEventEnd": 3611.2672285754975,
  //  "type": "reload",
  //  "redirectCount": 0
  //}

  //下面的函数check_PerformanceEntry的参数obj就是上面的p[0]
  //
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 2 name	Candidate Recommendation
Performance Timeline name	Recommendation	Initial definition.

Browser compatibility

BCD tables only load in the browser

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.