Performance Timeline API 使用一套用于度量客户端延迟的工具扩展了Performance 接口。性能度
量将会采用计算结束与开始时间差的形式。这些开始和结束时间会被记录为DOMHighResTimeStamp
值,而封装这个时间戳的对象是PerformanceEntry 的实例。
浏览器会自动记录各种PerformanceEntry 对象,而使用performance.mark()也可以记录自定
义的PerformanceEntry 对象。在一个执行上下文中被记录的所有性能条目可以通过performance.
getEntries()获取:
console.log(performance.getEntries());
// [PerformanceNavigationTiming, PerformanceResourceTiming, … ]
这个返回的集合代表浏览器的性能时间线(performance timeline)。每个PerformanceEntry 对象
都有name、entryType、startTime 和duration 属性:
const entry = performance.getEntries()[0];
console.log(entry.name); // “https://foo.com”
console.log(entry.entryType); // navigation
console.log(entry.startTime); // 0
console.log(entry.duration); // 182.36500001512468
不过,PerformanceEntry 实际上是一个抽象基类。所有记录条目虽然都继承PerformanceEntry,
但最终还是如下某个具体类的实例:
PerformanceMark
PerformanceMeasure
PerformanceFrameTiming
PerformanceNavigationTiming
PerformanceResourceTiming
PerformancePaintTiming
上面每个类都会增加大量属性,用于描述与相应条目有关的元数据。每个实例的name 和entryType
属性会因为各自的类不同而不同。
User Timing API
User Timing API 用于记录和分析自定义性能条目。如前所述,记录自定义性能条目要使用
performance.mark()方法:
performance.mark(‘foo’);
console.log(performance.getEntriesByType(‘mark’)[0]);
// PerformanceMark {
// name: “foo”,
// entryType: “mark”,
// startTime: 269.8800000362098,
// duration: 0
// }
在计算开始前和结束后各创建一个自定义性能条目可以计算时间差。最新的标记(mark)会被推到
getEntriesByType()返回数组的开始:
performance.mark(‘foo’);
for (let i = 0; i < 1E6; ++i) {}
performance.mark(‘bar’);
const [endMark, startMark] = performance.getEntriesByType(‘mark’);
console.log(startMark.startTime - endMark.startTime); // 1.3299999991431832
除了自定义性能条目,还可以生成PerformanceMeasure(性能度量)条目,对应由名字作为标
识的两个标记之间的持续时间。PerformanceMeasure 的实例由performance.measure()方法生成:
performance.mark(‘foo’);
for (let i = 0; i < 1E6; ++i) {}
performance.mark(‘bar’);
performance.measure(‘baz’, ‘foo’, ‘bar’);
const [differenceMark] = performance.getEntriesByType(‘measure’);
console.log(differenceMark);
// PerformanceMeasure {
// name: “baz”,
// entryType: “measure”,
// startTime: 298.9800000214018,
// duration: 1.349999976810068
// }
05-31
285
![](https://csdnimg.cn/release/blogv2/dist/pc/img/readCountWhite.png)