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

mark() 方法在浏览器的性能缓冲区中使用给定名称添加一个timestamp(时间戳)

应用定义的时间戳可以通过 Performance 接口的一个 getEntries*() 方法(getEntries(), getEntriesByName() 或者 getEntriesByType())检索到。

标记 的 performance entry将具有以下属性值:

  • entryType - 设置为 "mark".
  • name - 设置为mark被创建时给出的 "name"。
  • startTime - 设置为 mark() 方法被调用时的 timestamp
  • duration - 设置为 "0" (标记没有持续时间).

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

语法

performance.mark(name);

参数

name
一个表示标记名称的DOMString

返回值

 无
 

实例

下面的示例演示如何使用 mark() 来创建和检索PerformanceMark条目。

 

// 创建一些标记。
performance.mark("squirrel");
performance.mark("squirrel");
performance.mark("monkey");
performance.mark("monkey");
performance.mark("dog");
performance.mark("dog");

// 获取所有的 PerformanceMark 条目。
const allEntries = performance.getEntriesByType("mark");
console.log(allEntries.length);
// 6

// 获取所有的 "monkey" PerformanceMark 条目。
const monkeyEntries = performance.getEntriesByName("monkey");
console.log(monkeyEntries.length);
// 2

// 删除所有标记。
performance.clearMarks();

 

规范

规范 状态 注释
User Timing Level 2
mark()
Working Draft 阐明 mark() 处理模型。
User Timing
mark()
Recommendation 基础定义。

浏览器兼容

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

文档标签和贡献者

标签: 
此页面的贡献者: zmj97, mdnwebdocs-bot, Maple_Cao, yzw7489757, ihgazni2
最后编辑者: zmj97,