性能测量 | AIUI | Rokid

performance 用于测量代码运行时间和记录关键时间点。它适合定位“哪一步比较慢”,不用于获取当前日期或 Unix 时间戳。

性能测量

performance 用于测量代码运行时间和记录关键时间点。它适合定位“哪一步比较慢”,不用于获取当前日期或 Unix 时间戳。

测量一段代码

简单场景可以直接比较两次 performance.now():

const start = performance.now();
await loadData();
const duration = performance.now() - start;

console.log(`加载耗时 ${duration.toFixed(2)} ms`);

记录跨步骤耗时

使用 mark() 标记开始和结束位置,再用 measure() 生成一条测量记录:

performance.mark('load-start');
await loadData();
performance.mark('load-end');

const measure = performance.measure('load-data', 'load-start', 'load-end');
console.log(measure.duration);

performance.clearMarks();
performance.clearMeasures();

如果需要稍后统一分析,可以通过 getEntriesByType('measure') 读取所有测量记录。

查看应用内存估算

const result = await performance.measureUserAgentSpecificMemory();
console.log(`当前估算内存:${result.bytes} bytes`);

返回值是运行时对当前应用内存的估算,适合观察变化趋势,不应当视为设备的全部内存占用。

API Reference

performance.now()

返回相对于当前运行时高精度时间源的毫秒数。

performance.timeOrigin

当前性能时间线的起始时间,单位为毫秒。

performance.mark(name, options?)

添加并返回一个 PerformanceMark。options.startTime 可以指定时间,options.detail 可以附带自定义数据。

performance.measure(name, startOrOptions?, endMark?)

添加并返回一个 PerformanceMeasure。可以传入开始、结束标记名,也可以通过对象形式设置 start、end、duration 和 detail。

查询和清理记录

方法说明
getEntries()返回时间线中的全部记录。
getEntriesByType(type)按 entryType 查询记录,例如 mark 或 measure。
getEntriesByName(name, type?)按名称和可选类型查询记录。
clearMarks(name?)清除指定名称或全部标记。
clearMeasures(name?)清除指定名称或全部测量记录。

PerformanceEntry

每条记录都包含 name、entryType、startTime、duration,并支持 toJSON()。PerformanceMark 还包含 detail,其 duration 固定为 0;PerformanceMeasure 也可以包含 detail。

performance.measureUserAgentSpecificMemory()

返回 Promise<MemoryMeasurement>。结果包含总字节数 bytes 和分项信息 breakdown。