User Timing API
mark() 方法在浏览器的性能缓冲区中使用给定名称添加一个DOMHighResTimeStamp 。
应用定义的时间戳可以通过 Performance 接口的一个 getEntries*() 方法 (Performance.getEntries, Performance.getEntriesByName 或者 Performance.getEntriesByType) 检索到。
标记 的 PerformanceEntry将具有以下属性值:
- PerformanceEntry.entryType - 设置为 "
mark". - PerformanceEntry.name - 设置为 mark 被创建时给出的 "name"。
- PerformanceEntry.startTime - 设置为
mark()方法被调用时的 DOMHighResTimeStamp 。 - PerformanceEntry.duration - 设置为 "
0" (标记没有持续时间).
如果这个方法被指定的 name 已经存在于PerformanceTiming 接口,会抛出一个SyntaxError错误。
语法
mark(name)
mark(name, markOptions)
参数
- name
- : 一个表示标记名称的String。
返回值
无
实例
下面的示例演示如何使用 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();
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
