覆盖率类

覆盖率类提供了收集页面使用的 JavaScript 和 CSS 部分信息的方法。

签名

export declare class Coverage

备注

要以 Istanbul 可消费的形式输出覆盖率，请参阅 puppeteer-to-istanbul。

此类的构造函数标记为内部。第三方代码不应直接调用构造函数或创建扩展 Coverage 类的子类。

示例

一个使用 JavaScript 和 CSS 覆盖率来获取初始执行代码百分比的示例

// Enable both JavaScript and CSS coverage
await Promise.all([
  page.coverage.startJSCoverage(),
  page.coverage.startCSSCoverage(),
]);
// Navigate to page
await page.goto('https://example.com');
// Disable both JavaScript and CSS coverage
const [jsCoverage, cssCoverage] = await Promise.all([
  page.coverage.stopJSCoverage(),
  page.coverage.stopCSSCoverage(),
]);
let totalBytes = 0;
let usedBytes = 0;
const coverage = [...jsCoverage, ...cssCoverage];
for (const entry of coverage) {
  totalBytes += entry.text.length;
  for (const range of entry.ranges) usedBytes += range.end - range.start - 1;
}
console.log(`Bytes used: ${(usedBytes / totalBytes) * 100}%`);

方法

方法	修饰符	描述
startCSSCoverage(options)
startJSCoverage(options)		备注 匿名脚本是指没有关联 URL 的脚本。这些脚本是在页面上使用 eval 或 new Function 动态创建的。如果 reportAnonymousScripts 设置为 true，则匿名脚本 URL 将以 debugger://VM 开头（除非存在魔术 //# sourceURL 注释，在这种情况下，这将是 URL）。
stopCSSCoverage()		Promise，它解析为所有样式表的覆盖率报告数组。 备注 CSS 覆盖率不包括没有 sourceURL 的动态注入样式标签。
stopJSCoverage()		Promise，它解析为所有脚本的覆盖率报告数组。 备注 JavaScript 覆盖率默认不包括匿名脚本。但是，会报告具有 sourceURL 的脚本。