Puppeteer 中文文档v25.8.0

Coverage 类

Coverage 类提供了收集页面所使用的 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 的脚本。这些脚本是在页面上通过 evalnew Function 动态创建的脚本。如果 reportAnonymousScripts 设置为 true,匿名脚本 URL 将以 debugger://VM 开头(除非存在 magic //# sourceURL 注释,在这种情况下该注释将成为 URL)。

stopCSSCoverage()

解析为所有样式表的覆盖报告数组的 Promise。

备注:

CSS 覆盖不包含没有 sourceURL 的动态注入的样式标签。

stopJSCoverage()

解析为所有脚本的覆盖报告数组的 Promise。

备注:

默认情况下,JavaScript 覆盖不包含匿名脚本。但是,带有 sourceURL 的脚本会被报告。