最强自动化测试框架Playwright（31）-键盘事件

Keyboard对象提供api管理虚拟的键盘，高级别的接口是keyboard.type()，并且接受keydown，keypress,input，keyup事件

方法

down

`keyboard.down(key[, options])` 方法用于模拟按下键盘按键，但不会立即触发事件。它只会触发 `keydown` 事件，表示按键按下，但不会触发 `keypress` 或 `keyup` 事件。

以下是 `keyboard.down()` 方法的几个重要参数：

- `key` (字符串): 表示要模拟按下的按键。可以是单个字符，也可以是键盘的功能键，如 "Enter"、"Shift"、"Control" 等。

- `options` (可选参数): 一个对象，用于指定其他的选项。例如：
  - `delay` 控制触发 `keydown` 事件的时间间隔。默认为 0，表示立即触发事件。
  - `text` 用于模拟按下多个按键组成的文本。

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as playwright:
    # 启动浏览器
    browser = playwright.chromium.launch()
    
    # 创建一个新的上下文
    context = browser.new_context()
    
    # 在上下文中创建一个新的页面
    page = context.new_page()
    
    # 跳转到页面
    page.goto('https://example.com')
    
    # 获取键盘对象
    keyboard = page.keyboard
    
    # 使用 down() 方法模拟按下 Shift 键
    keyboard.down('Shift')
    
    # 模拟按下了 'A' 键
    keyboard.press('A')
    
    # 关闭浏览器
    browser.close()
```

以下是一个示例，演示了 `keyboard.down()` 方法的使用：

在上述示例中，我们使用 `keyboard.down('Shift')` 方法模拟按下 Shift 键，并紧接着使用 `keyboard.press('A')` 方法模拟按下了 A 键。然后，可以进一步调用其他键盘操作方法，如 `keyboard.up()` 来释放按键。

请注意，`keyboard.down()` 方法只触发 `keydown` 事件，不会触发 `keypress` 或 `keyup` 事件。如果需要模拟释放键盘按键，需要调用 `keyboard.up()` 方法。

insert_text

插入文本

page.keyboard.insert_text("嗨")

press

`keyboard.press(key[, options])` 方法用于模拟按下并释放键盘按键，它会立即触发 `keydown`、`keypress` 和 `keyup` 事件，就像用户在同一时间按下并释放按键一样。

以下是 `keyboard.press()` 方法的几个重要参数：

- `key` (字符串): 表示要模拟按下的按键。可以是单个字符，也可以是键盘的功能键，如 "Enter"、"Shift"、"Control" 等。

- `options` (可选参数): 一个对象，用于指定其他的选项。例如：
  - `delay` 控制触发 `keydown` 和 `keyup` 事件的时间间隔。默认为 0，表示立即触发事件。
  - `text` 用于模拟按下多个按键组成的文本。

以下是一个示例，演示了 `keyboard.press()` 方法的使用：

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as playwright:
    # 启动浏览器
    browser = playwright.chromium.launch()
    
    # 创建一个新的上下文
    context = browser.new_context()
    
    # 在上下文中创建一个新的页面
    page = context.new_page()
    
    # 跳转到页面
    page.goto('https://example.com')
    
    # 获取键盘对象
    keyboard = page.keyboard
    
    # 使用 press() 方法模拟按下并释放回车键
    keyboard.press('Enter')
    
    # 关闭浏览器
    browser.close()
```

在上述示例中，我们使用 `keyboard.press('Enter')` 方法模拟按下了回车键，并立即触发`keydown`、`keypress` 和 `keyup` 事件。

请注意，`keyboard.press()` 方法会立即触发 `keydown`、`keypress` 和 `keyup` 事件，因此无需调用其他方法来释放按键。如果只需要模拟按下按键或释放按键，可以分别使用 `keyboard.down()` 和 `keyboard.up()` 方法。

type

`keyboard.type()` 方法用于模拟键盘输入文本，将指定的文本一次性输入到活动元素（或指定的元素）中。它会模拟依次按下每个字符的过程，并触发相应的键盘事件，包括 `keydown`、`keypress` 和 `keyup`。

以下是 `keyboard.type()` 方法的几个重要参数：

- `text` (字符串): 要模拟输入的文本。

- `options` (可选参数): 一个对象，用于指定其他的选项。例如：
  - `delay` 控制触发每个字符的时间间隔。默认为 0，表示立即触发事件。
  - `timeout` 控制键入每个字符之间的最大等待时间。如果键入速度较慢，可以适当增加此值。

以下是一个示例，演示了 `keyboard.type()` 方法的使用：

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as playwright:
    # 启动浏览器
    browser = playwright.chromium.launch()
    
    # 创建一个新的上下文
    context = browser.new_context()
    
    # 在上下文中创建一个新的页面
    page = context.new_page()
    
    # 打开一个示例页面
    page.goto('https://example.com')
    
    # 获取活动元素，并在输入框中键入文本
    page.keyboard.type('Hello, World!')
    
    # 关闭浏览器
    browser.close()
```

在上述示例中，我们使用 `keyboard.type()` 方法模拟键入文本"Hello, World!"，将这些字符输入到当前活动页面上的文本输入框中。

请注意，`keyboard.type()` 方法会模拟一次性输入所有的字符，并触发相应的键盘事件。如果需要控制键入速度或模拟按下特定的按键，请考虑使用其他的键盘操作方法，如 `keyboard.press()` 或 `keyboard.down()`。

up

keyboard.up(key)