class: Keyboard
Keyboard 提供一个接口来管理虚拟键盘. 高级接口为 keyboard.type, 其接收原始字符, 然后在你的页面上生成对应的 keydown, keypress/input, 和 keyup 事件.
为了更精细的控制(虚拟键盘), 你可以使用 keyboard.down, keyboard.up 和 keyboard.sendCharacter 来手动触发事件, 就好像这些事件是由真实的键盘生成的.
持续按下 Shift 来选择一些字符串并且删除的例子:
await page.keyboard.type('Hello World!');
await page.keyboard.press('ArrowLeft');
await page.keyboard.down('Shift');
for (let i = 0; i < ' World'.length; i++)
await page.keyboard.press('ArrowLeft');
await page.keyboard.up('Shift');
await page.keyboard.press('Backspace');
// 结果字符串最终为 'Hello!'按下 A 的例子:
await page.keyboard.down('Shift');
await page.keyboard.press('KeyA');
await page.keyboard.up('Shift');注意 在 MacOS 上,
⌘ A-> 选择全部等键盘快捷键不工作. 另见 #1313
keyboard.down(key[, options])
key<string> 按下的键名, 比如ArrowLeft. 一个包含所有键名的列表见 USKeyboardLayout.options<Object> -text<string> 如果指定，则使用此文本生成输入事件.- returns: <Promise>
会分发一个 keydown 事件。
如果 key 是一个单独字符并且没有除了 Shift 的其他修饰符键正在被按下, 一个 keypress/input 事件也将被生成. 可以指定 text 选项来强制生成输入事件。
如果 key 是一个修饰键, Shift, Meta, Control, 或者是 Alt, 随后的按键将与该修饰符一起发送. 要释放修饰键, 请使用 keyboard.up。
在键被按下一次之后(译者注: 按下之后没有被释放, 一般会持续的触发该按键), 随后将持续调用 keyboard.down, 事件对象的 repeat 将被设置为 true. 要释放该键, 请使用 keyboard.up.
注意 修饰键会影响
keyboard.down, 持续按下Shift键将以大写形式输入文本。
keyboard.press(key[, options])
key<string> 按下的键名, 比如ArrowLeft. 一个包含所有键名的列表见 USKeyboardLayout。options<Object> -text<string> 如果指定，则使用此文本生成输入事件。 -delay<number> 在keydown和keyup间隔的时间, 以毫秒为单位. 默认为 0。- returns: <Promise>
如果 key 是一个单独字符并且没有除了 Shift 的其他修饰符键正在被按下, 一个 keypress/input 事件也将被生成。可以指定 text 选项来强制生成输入事件。
注意 修饰键会影响
keyboard.press, 持续按下Shift键将已大写形式输入文本。
keyboard.down 和 keyboard.up 的快捷方式。
keyboard.sendCharacter(char)
分发一个 keypress 和 input 事件。该方法不会发送 keydown 或 keyup 事件。
page.keyboard.sendCharacter('嗨');注意 修饰键不会影响
keyboard.sendCharacter。持续按下Shift键将不会已大写形式输入文本。
keyboard.type(text, options)
text<string> 要输入到焦点元素中的文本。options<Object> -delay<number> 按键间隔的时间, 以毫秒为单位. 默认为 0。- returns: <Promise>
为文本中的每个字符发送一个keydown, keypress/input 和 keyup 事件。
要按下一个特别的键, 像 Control 或 ArrowDown. 请使用keyboard.press
page.keyboard.type('Hello'); // 立即输入
page.keyboard.type('World', {delay: 100}); // 更缓慢的输入, 像一个用户注意 修饰键不会影响
keyboard.type。持续按下Shift键将不会已大写形式输入文本。
keyboard.up(key)
key<string> 要释放的键的键名, 例如ArrowLeft。一个包含所有键名的列表见 USKeyboardLayout。- returns: <Promise>
分发一个 keyup 事件。