tap([options])

注意
此功能存在已知问题。详情请参阅 #436 和 #471。

点按选定的元素。

参数	类型	默认值	描述
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.timeout	number	`30000`	最大时间（毫秒）。传递 `0` 以禁用超时。默认值被 BrowserContext 或 Page 上的 `setDefaultTimeout` 选项覆盖。
options.trial	boolean	`false`	设置为 `true` 将执行可操作性检查，而不实际执行操作。

返回值

类型	描述
`Promise<void>`	一个在点按操作完成后实现的 Promise。

示例

import { browser } from 'k6/browser';

export default async function () {
  const page = await browser.newPage({
    hasTouch: true,
  });

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