Performance.mark()

这篇翻译不完整。请帮忙从英语翻译这篇文章

mark() 方法添加一个timestamp 在浏览器具有指定名称的性能加载缓冲区中添加一个记录.程序定义的时间戳可以通过一个被检索 Performance 接口的 getEntries*() 方法 (getEntries(), getEntriesByName() 或者 getEntriesByType()).

mark's  performance entry将具有以下属性值:

  • entryType - 可以设置 "mark".
  • name - 设置名称为创建标记时的“名称”.
  • startTime - 设置 为timestamp 当 mark() 方法被调用时.
  • duration - 设置为 "0" (标记没有持续时间).

如果 name 指定的这个方法已经存在于PerformanceTiming 接口, SyntaxError会抛出一个错误.

Syntax

performance.mark(name);

Arguments

name
DOMString表示标记的名称.

Return value

 无
 

Example

下面的示例演示如何使用mark() 来创建应用程序定义的peformance entry 在浏览器中执行记录缓冲

function create_mark(name) {
  if (performance.mark === undefined) {
    console.log("performance.mark Not supported");
    return;
  }
  // Create the performance mark
  performance.mark(name);
  // mark 方法是可以创建多条同名 performanceEntry 的,例如:
  // performance.mark("begin")
  // performance.mark("begin")
  // performance.mark("begin")
  // performance.mark("begin")
  // performance.getEntriesByName("begin")
  //    [...]
  //        0: PerformanceMark { name: "begin", entryType: "mark", startTime: 94661370.14, … }
  //        ​1: PerformanceMark { name: "begin", entryType: "mark", startTime: 95542853.4, … }​
  //        2: PerformanceMark { name: "begin", entryType: "mark", startTime: 95545560.92, … }​
  //        3: PerformanceMark { name: "begin", entryType: "mark", startTime: 95548089.94, … }​
  //        length: 4​
  //        __proto__: Array [] 
}

Specifications

Specification Status Comment
User Timing Level 2
mark()
Working Draft Clarifies mark() processing model.
User Timing
mark()
Recommendation Basic definition.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic Support 43.0 (Yes) 41 10 33 未实现
Feature Android Android Webview Edge Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic Support 未实现 46.0 (Yes) 42 42 10 33 未实现 46.0

文档标签和贡献者

标签: 
此页面的贡献者: yzw7489757, ihgazni2
最后编辑者: yzw7489757,