press(selector, key[, options])

警告
请改用基于 locator 的 locator.press()。

聚焦元素，然后使用 keyboard.down(key) 和 keyboard.up(key)。

key 值的超集可在此处找到。

还支持以下修饰符快捷键：Shift、Control、Alt、Meta、ShiftLeft。

按住 Shift 将输入与 key 对应的大写文本。

如果 key 是单个字符，则区分大小写，因此值 a 和 A 将分别生成不同的文本。

还支持 key: "Control+o" 或 key: "Control+Shift+T" 等快捷键。与修饰符一起指定时，在按下后续键的同时按下并按住修饰符。

参数	类型	默认值	描述
selector	string	`''`	用于搜索元素的 selector。如果存在多个满足 selector 的元素，将使用第一个。
key	string	`''`	要按下的键的名称或要生成的字符，例如 `ArrowLeft` 或 `a`。键值的超集可在此处找到。
options	object	`null`
options.delay	number	`0`	`keydown` 和 `keyup` 之间的等待毫秒数。
options.noWaitAfter	boolean	`false`	如果设置为 `true` 并且执行此操作导致了导航，则不会等待其完成。
options.strict	boolean	`false`	当 `true` 时，调用要求 selector 解析为一个元素。如果给定的 selector 解析为多个元素，则调用将抛出异常。
options.timeout	number	`30000`	最大时间（毫秒）。传入 `0` 禁用超时。默认值会被 BrowserContext 或 Page 的 `setDefaultTimeout` 选项覆盖。

类型	描述
`Promise<void>`	一个在按下操作完成后履行的 Promise。

本页是否有帮助？