键盘

Keyboard提供了一个用于管理虚拟键盘的API。高级API是Keyboard.type()，它接收原始字符并在您的页面上生成适当的keydown、keypress/input和keyup事件。

如需更精细的控制，您可以使用 Keyboard.down()、Keyboard.up() 和 Keyboard.insertText() 来手动触发事件，就像它们是由真实键盘生成的一样。

一个按住Shift键来选择并删除某些文本的示例：

page.keyboard().type("Hello World!");
page.keyboard().press("ArrowLeft");
page.keyboard().down("Shift");
for (int i = 0; i < " World".length(); i++)
  page.keyboard().press("ArrowLeft");
page.keyboard().up("Shift");
page.keyboard().press("Backspace");
// Result text will end up saying "Hello!"

一个按下大写字母 A 的示例

page.keyboard().press("Shift+KeyA");
// or
page.keyboard().press("Shift+A");

一个使用键盘触发全选的示例

page.keyboard().press("ControlOrMeta+A");

方法​

下载​

触发一个keydown事件。

key 可以指定预期的 keyboardEvent.key 值或单个字符来生成文本。可以在这里找到key值的超集。按键示例如下：

F1 - F12, Digit0- Digit9, KeyA- KeyZ, Backquote, Minus, Equal, Backslash, Backspace, Tab, Delete, Escape, ArrowDown, End, Enter, Home, Insert, PageDown, PageUp, ArrowRight, ArrowUp, 等。

还支持以下修改快捷键：Shift、Control、Alt、Meta、ShiftLeft、ControlOrMeta。ControlOrMeta在Windows和Linux上解析为Control，在macOS上解析为Meta。

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

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

如果key是修饰键Shift、Meta、Control或Alt，后续按键操作将保持该修饰键处于激活状态。要释放修饰键，请使用Keyboard.up()。

按键被按下一次后，后续调用Keyboard.down()时repeat将被设置为true。要释放按键，请使用Keyboard.up()。

用法

Keyboard.down(key);

参数

• key String#

  要按下的键的名称或要生成的字符，例如 ArrowLeft 或 a。

返回

• void#

insertText​

仅触发input事件，不会发出keydown、keyup或keypress事件。

用法

page.keyboard().insertText("嗨");

参数

• text String#

  将输入设置为指定的文本值。

返回

• void#

按下​

key 可以指定预期的 keyboardEvent.key 值或单个字符来生成文本。可以在这里找到key值的超集。按键示例如下：

F1 - F12, Digit0- Digit9, KeyA- KeyZ, Backquote, Minus, Equal, Backslash, Backspace, Tab, Delete, Escape, ArrowDown, End, Enter, Home, Insert, PageDown, PageUp, ArrowRight, ArrowUp, 等。

还支持以下修改快捷键：Shift、Control、Alt、Meta、ShiftLeft、ControlOrMeta。ControlOrMeta在Windows和Linux上解析为Control，在macOS上解析为Meta。

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

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

诸如key: "Control+o"、key: "Control++或key: "Control+Shift+T"之类的快捷键也同样支持。当指定修饰键时，修饰键会被按下并保持按住状态，同时后续的键被按下。

用法

Page page = browser.newPage();
page.navigate("https://keycode.info");
page.keyboard().press("A");
page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("A.png")));
page.keyboard().press("ArrowLeft");
page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("ArrowLeft.png")));
page.keyboard().press("Shift+O");
page.screenshot(new Page.ScreenshotOptions().setPath(Paths.get("O.png")));
browser.close();

Keyboard.down() 和 Keyboard.up() 的快捷方式。

参数

• key String#

  要按下的键的名称或要生成的字符，例如ArrowLeft或a。

• options Keyboard.PressOptions (可选)

  • setDelay double (可选)#

    在keydown和keyup之间等待的时间，以毫秒为单位。默认为0。

返回

• void#

类型​

为文本中的每个字符发送keydown、keypress/input和keyup事件。

要按下特殊键，如Control或ArrowDown，请使用Keyboard.press()。

用法

// Types instantly
page.keyboard().type("Hello");
// Types slower, like a user
page.keyboard().type("World", new Keyboard.TypeOptions().setDelay(100));

参数

• text String#

  要输入到已聚焦元素中的文本。

• options Keyboard.TypeOptions (可选)

  • setDelay double (可选)#

    按键之间的等待时间，以毫秒为单位。默认为0。

返回

• void#

向上​

触发一个 keyup 事件。

用法

Keyboard.up(key);

参数

• key String#

  要按下的键的名称或要生成的字符，例如ArrowLeft或a。

返回

• void#