press(key, [options])

按下键盘上的单个按键或组合按键。

参数	类型	默认值	描述
key	string	`''`	要按下的按键名称或要生成的字符，例如 `ArrowLeft` 或 `a`。可以在此处找到按键值的超集此处。
options	object	`null`
options.delay	number	`0`	等待毫秒数，介于 `keydown` 和 `keyup` 之间。
options.noWaitAfter	boolean	`false`	如果设置为 `true` 并且执行此操作导致导航发生，则不会等待其完成。
options.timeout	number	`30000`	最大时间（毫秒）。传入 `0` 以禁用超时。默认值会被 BrowserContext 或 Page 上的 `setDefaultTimeout` 选项覆盖。

返回值

类型	描述
`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();
  await page.goto('https://test.k6.io/browser.php');
  const text = page.locator('#text1');
  await text.press('i');
  await text.press('ArrowLeft');
  await text.press('h');
}