在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 相关话题

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.

注意： 此特征可用于 Web 工作者 .

句法

entries = window.performance.getEntriesByName(name, type);
					

自变量

名称

The name of the entry to retrieve.

type 可选

The type of entry to retrieve such as " mark ". The valid entry types are listed in PerformanceEntry.entryType .

返回值

entries

列表化的 PerformanceEntry objects that have the specified 名称 and type 。若 type argument is not specified, only the 名称 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.

范例

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);
  }
}
					

规范

规范	状态	注释
Performance Timeline Level 2 The definition of 'getEntriesByName()' in that specification.	候选推荐
性能时间线 The definition of 'getEntriesByName()' in that specification.	推荐	初始定义。

浏览器兼容性

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. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
getEntriesByName	Chrome 28 28 25 — 36 Prefixed Prefixed Implemented with the vendor prefix: webkit	Edge 12	Firefox Yes	IE Yes	Opera 不支持 No	Safari 11	WebView Android Yes	Chrome Android 28 28 25 — 36 Prefixed Prefixed Implemented with the vendor prefix: webkit	Firefox Android 25	Opera Android 不支持 No	Safari iOS 11	Samsung Internet Android 1.5 1.5 1.5 — 3.0 Prefixed Prefixed Implemented with the vendor prefix: webkit

图例

完整支持

完整支持

不支持

不支持

要求使用供应商前缀或不同名称。

要求使用供应商前缀或不同名称。

元数据

• 最后修改： Apr 4, 2019

相关话题

1. 性能时间线
2. 性能
3. 特性

   1. navigation
   2. onresourcetimingbufferfull
   3. timeOrigin
   4. timing
4. 方法

   1. clearMarks()
   2. clearMeasures()
   3. clearResourceTimings()
   4. getEntries()
   5. getEntriesByName()
   6. getEntriesByType()
   7. mark()
   8. measure()
   9. now()
   10. setResourceTimingBufferSize()
   11. toJSON()
5. 事件

   1. resourcetimingbufferfull
6. Related pages for Performance Timeline API

   1. PerformanceEntry
   2. PerformanceObserver
   3. PerformanceObserverEntryList
   4. PerformanceResourceTiming
   5. Window.performance