大网数据广告活动
Web 标准与前端开发

Performance.mark()

· 52CE 我爱测

`mark()`** 方法在浏览器的性能缓冲区中使用给定名称添加一个DOMHighResTimeStamp _。_

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。