菜单
开源

boundingBox()

返回元素的边界框。边界框是相对于当前 ElementHandleFrame 位置计算的,通常是 Page 的主框架。

返回值

类型描述
Promise<null | Rect>一个 Promise,其结果是元素的边界框,类型为 Rect。如果元素不可见,Promise 会解析为 null

Rect

Rect 对象表示元素的边界框。

属性类型描述
xnumber元素的 x 坐标(像素)。
ynumber元素的 y 坐标(像素)。
widthnumber元素的宽度(像素)。
heightnumber元素的高度(像素)。

示例

JavaScript
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.$('#text1');
  const boundingBox = await element.boundingBox();
  console.log(`x: ${boundingBox.x}, y: ${boundingBox.y}, width: ${boundingBox.width}, height: ${boundingBox.height}`);

  await page.close();
}