screenshot([options])

获取元素的屏幕截图。

参数	类型	默认值	描述
options	object	`null`
options.path	string	`''`	保存图像的文件路径。屏幕截图类型将从文件扩展名推断。如果 `path` 是相对路径，则它相对于当前工作目录解析。如果未提供路径，图像将不会保存到磁盘。
options.format	string	`png`	指定屏幕截图类型。可接受的值为 `jpeg` 和 `png`。
options.omitBackground	boolean	`false`	隐藏默认的白色背景，并允许捕获带透明度的屏幕截图。不适用于 `jpeg` 图像。
options.quality	number	`100`	图像质量，介于 0-100 之间；仅适用于 `jpeg`。
options.timeout	number	`30000`	最大时间，单位为毫秒。传入 `0` 可禁用超时。默认值会被 BrowserContext 或 Page 上的 `setDefaultTimeout` 选项覆盖。

返回值

类型	描述
`Promise<ArrayBuffer \| null>`	包含捕获的屏幕截图的 ArrayBuffer。

示例

import { browser } from 'k6/browser';

export const options = {
  scenarios: {
    browser: {
      executor: 'shared-iterations',
      options: {
        browser: {
          type: 'chromium',
        },
      },
    },
  },
};

export default async function () {
  const page = await browser.newPage();
  await page.goto('https://test.k6.io/browser.php');

  const element = await page.$(".header");
  const screenshot = await element.screenshot({
    path: 'header.png'
  });

  await page.close();
}