跳转到主要内容

Coverage

覆盖率收集有关页面使用的 JavaScript 和 CSS 部分的信息。

一个使用 JavaScript 覆盖率来为页面加载生成 Istanbul 报告的示例

注意

覆盖率 API 仅在基于 Chromium 的浏览器中受支持。

const { chromium } = require('playwright');
const v8toIstanbul = require('v8-to-istanbul');

(async () => {
  const browser = await chromium.launch();
  const page = await browser.newPage();
  await page.coverage.startJSCoverage();
  await page.goto('https://chromium.org');
  const coverage = await page.coverage.stopJSCoverage();
  for (const entry of coverage) {
    const converter = v8toIstanbul('', 0, { source: entry.source });
    await converter.load();
    converter.applyCoverage(entry.functions);
    console.log(JSON.stringify(converter.toIstanbul()));
  }
  await browser.close();
})();

方法​

startCSSCoverage​

添加于：v1.11 coverage.startCSSCoverage

返回覆盖率已启动

用法

await coverage.startCSSCoverage();
await coverage.startCSSCoverage(options);

参数

  • options Object (可选)

    • resetOnNavigation 布尔值 (可选)#

      是否在每次导航时重置覆盖率。默认为 true。

返回

startJSCoverage​

添加于：v1.11 coverage.startJSCoverage

返回覆盖率已启动

注意

匿名脚本是没有关联 URL 的脚本。这些脚本是使用 eval 或 new Function 在页面上动态创建的。如果 reportAnonymousScripts 设置为 true，匿名脚本的 URL 将是 __playwright_evaluation_script__。

用法

await coverage.startJSCoverage();
await coverage.startJSCoverage(options);

参数

  • options Object (可选)

    • reportAnonymousScripts 布尔值 (可选)#

      是否报告页面生成的匿名脚本。默认为 false。

    • resetOnNavigation 布尔值 (可选)#

      是否在每次导航时重置覆盖率。默认为 true。

返回

stopCSSCoverage​

添加于：v1.11 coverage.stopCSSCoverage

返回所有样式表的覆盖率报告数组

注意

CSS 覆盖率不包括没有 sourceURLs 的动态注入的 style 标签。

用法

await coverage.stopCSSCoverage();

返回

stopJSCoverage​

添加于：v1.11 coverage.stopJSCoverage

返回所有脚本的覆盖率报告数组

注意

JavaScript 覆盖率默认不包括匿名脚本。但是，带有 sourceURLs 的脚本会被报告。

用法

await coverage.stopJSCoverage();

返回