# 键盘按键

节点类型 `browser_keyboard`

## 功能说明

在浏览器页面中发送按键或组合键。

## 客户端配置界面

![键盘按键节点的客户端配置界面](/assets/keyboard.2fcec0227d06b9f9e907ceb3cb88ab3b536905f82d01413d15fd3fa245c82d61.0538f3a9.webp)

截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。

## 输入字段

以下字段位于 `data.browserUi.inputs`。

| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|  --- | --- | --- | --- | --- |
| `type` | `"custom"` / `"Enter"` / `"Tab"` / `"Escape"` / `"Space"` / `"Backspace"` / `"Delete"` / `"ArrowUp"` / `"ArrowDown"` / `"ArrowLeft"` / `"ArrowRight"` / `"Home"` / `"End"` / `"Control+KeyA"` / `"Control+KeyC"` / `"Control+KeyV"` / `"Control+KeyR"`（支持变量引用） | 否 | `"Enter"` | 按键 编辑器初值 `"Enter"` |
| `customCommand` | `string` | 否 | — | 自定义按键 |
| `postWaitMs` | `WorkflowNumber` | 否 | `300` | 完成后等待时长（毫秒）; minimum after resolution: 0 编辑器初值 `300` |


## 条件与边界

**`type` `eq` `"custom"`**

- 必填 `customCommand`
- 有效按键组合，不接受未知键。
- 校验错误码 `RPA_NODE_INPUT_INVALID`
- type=custom 时必须提供 customCommand；预设 Control 快捷键在 macOS 转为 Meta，自定义组合保持原样。预设 Ctrl/⌘+R 直接刷新页面；macOS 上预设 Ctrl/⌘+A/C/V 随按键发送全选/复制/粘贴编辑命令。
- 校验错误码 `RPA_NODE_INPUT_INVALID`


## 输入引用

| 字段 | 允许的形式 |
|  --- | --- |
| `type` | `literal`, `template` |
| `customCommand` | `literal`, `template` |
| `postWaitMs` | `literal`, `numericExpression` |


## 输出字段

| 输出字段 | 类型或取值 |
|  --- | --- |
| `tabId` | `string` |
| `url` | `string` |
| `openedTabs` | array<`TabInfo`> |


按契约用 `${nodeId.data.field}` 引用公开字段。

## JSON 示例

可放入流程 `nodes` 数组或其他节点 `blocks` 中的完整节点对象。

```json
{
  "id": "press_enter",
  "type": "browser_keyboard",
  "data": {
    "title": "按回车提交搜索",
    "browserAction": "keyboard",
    "browserUi": {
      "inputs": {
        "type": "Enter",
        "postWaitMs": 300
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[返回节点目录](/zh/browser-rpa/nodes)