跳到主要内容

覆盖率

覆盖率收集有关页面使用的 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 boolean (可选)#

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

返回

startJSCoverage​

在以下版本中添加：v1.11 coverage.startJSCoverage

返回覆盖率已启动

注意

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

用法

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

参数

  • options Object (可选)

    • reportAnonymousScripts boolean (可选)#

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

    • resetOnNavigation boolean (可选)#

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

返回

stopCSSCoverage​

在以下版本中添加：v1.11 coverage.stopCSSCoverage

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

注意

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

用法

await coverage.stopCSSCoverage();

返回

  • Promise<Array<Object>>#

    • url string

      样式表 URL

    • text string (可选)

      样式表内容（如果可用）。

    • ranges Array<Object>

      • start number

        文本中的起始偏移量（包含）。

      • end number

        文本中的结束偏移量（不包含）。

      已使用的样式表范围。范围已排序且不重叠。

stopJSCoverage​

在以下版本中添加：v1.11 coverage.stopJSCoverage

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

注意

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

用法

await coverage.stopJSCoverage();

返回