tap(selector[, options])

轻触与选择器匹配的第一个元素。

参数	类型	默认	描述
selector	string	`''`	用于搜索元素的选择器。如果多个元素满足选择器，则使用第一个匹配的元素。
options	object	`null`
options.force	boolean	`false`	将其设置为 `true` 将绕过可操作性检查（`visible`, `stable`, `enabled`）。
options.modifiers	string[]	`null`	操作期间按下的 `Alt`, `Control`, `Meta` 或 `Shift` 修饰键。如果未指定，则使用当前按下的修饰键。
options.noWaitAfter	boolean	`false`	如果设置为 `true` 且执行此操作导致导航发生，则不会等待其完成。
options.position	object	`null`	相对于元素左上角使用的点。如果未提供，则使用元素的可见点。
options.position.x	number	`0`	X 坐标。
options.position.y	number	`0`	Y 坐标。
options.strict	boolean	`false`	当 `true` 时，调用要求选择器解析为单个元素。如果给定的选择器解析为多个元素，则调用会抛出异常。
options.timeout	number	`30000`	最大时间（毫秒）。传入 `0` 禁用超时。默认值由 BrowserContext 或 Page 上的 `setDefaultTimeout` 选项覆盖。
options.trial	boolean	`false`	将其设置为 `true` 将执行可操作性检查，但不执行实际操作。

返回值

类型	描述
`Promise<void>`	一个 Promise，在轻触操作完成时实现。

示例

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({
    hasTouch: true,
  });

  await page.goto('https://test.k6.io/browser.php');
  const frame = page.mainFrame();
  await frame.tap("#numbers-options");
}