Performance.mark() - Web API 接口参考 编辑

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!

• Desktop
• Mobile

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