网页输入快捷键

指令说明

在指定网页中通过 Chrome CDP 静默发送键盘按下和抬起事件，用于执行网页内快捷键，例如 Ctrl+A 全选、Ctrl+C 复制、Ctrl+V 粘贴、Enter 提交、Tab 切换焦点、Delete 删除、方向键移动等。

该指令作用于整个网页，不绑定某一个网页元素。如果需要让某个输入框、编辑器或者按钮接收快捷键，需要先通过点击网页元素等指令让目标元素获得焦点，然后再执行本指令。

如果用户要输入一段普通文本，优先使用填写网页输入框；如果用户要对当前系统焦点或桌面软件按快捷键，使用键盘输入。只有当快捷键需要在指定浏览器网页中后台静默执行时，才使用本指令。

指令输入参数

输入参数	输入参数类型	说明
网页对象	WebPage	在该网页中输入快捷键。通常来自打开网页或获取已打开的网页
快捷键	json数组	按键事件数组，按真实按下和抬起顺序排列。每一项包含 `type`、`code`、`delay`，格式参考下面的快捷键格式说明
输入完成等待时长	float	快捷键输入完成后等待一会儿再继续执行后续指令，单位：秒，默认 1

指令输出参数

无

快捷键格式说明

快捷键必须是数组，数组中的每一项表示一次按键事件：

字段	类型	说明
type	str	只能是 `"down"` 或 `"up"`。`"down"` 表示按下按键，`"up"` 表示抬起按键
code	number	Windows 虚拟键码，例如 Ctrl 常用 162，A 是 65，C 是 67，V 是 86，Enter 是 13，Tab 是 9，Delete 是 46
delay	number	相对上一事件的等待时间，单位毫秒。可以为 0

组合键必须保持真实按键顺序：先按下辅助键，再按下主键，然后抬起主键，最后抬起辅助键。例如 Ctrl+A 的顺序是 Ctrl down、A down、A up、Ctrl up。

常用按键虚拟键码：

按键	code
Ctrl	162 或 163
Alt	164 或 165
Shift	160 或 161
Tab	9
Enter	13
Esc	27
Backspace	8
Delete	46
方向左/上/右/下	37 / 38 / 39 / 40
A-Z	65-90
0-9	48-57
F1-F12	112-123

AI生成流程注意事项

生成 DescJson 时，ins 必须是 "网页输入快捷键"。
输入字段只有 "网页对象"、"快捷键"、"输入完成等待时长"，不要生成 "网页元素"、"输入内容"、"输入方式" 等字段。
本指令不会自动选择具体输入框。如果快捷键需要作用于某个输入框或编辑器，应先生成点击或聚焦该元素的步骤。
本指令适合快捷键和按键事件，不适合批量输入普通文本。普通文本输入应使用 "填写网页输入框"。
快捷键数组必须包含按下和抬起事件，不能只写按下事件。

Ctrl+A 示例

{
  "children": [],
  "in": {
    "网页对象": "webPage",
    "快捷键": [
      {
        "type": "down",
        "code": 162,
        "delay": 0
      },
      {
        "type": "down",
        "code": 65,
        "delay": 0
      },
      {
        "type": "up",
        "code": 65,
        "delay": 120
      },
      {
        "type": "up",
        "code": 162,
        "delay": 120
      }
    ],
    "输入完成等待时长": "1"
  },
  "out": {},
  "comments": "在网页中按下 Ctrl+A 全选",
  "ins": "网页输入快捷键"
}

按下 Enter 示例

{
  "children": [],
  "in": {
    "网页对象": "webPage",
    "快捷键": [
      {
        "type": "down",
        "code": 13,
        "delay": 0
      },
      {
        "type": "up",
        "code": 13,
        "delay": 80
      }
    ],
    "输入完成等待时长": "1"
  },
  "out": {},
  "comments": "在网页中按下 Enter",
  "ins": "网页输入快捷键"
}

类型定义参考

Python网页相关对象类型定义

提示

需要先安装曲辕RPA浏览器插件
该指令通过 Chrome CDP 发送按键事件，不抢夺鼠标，不要求浏览器窗口在屏幕最前方
如果快捷键没有生效，优先检查目标网页或目标输入框是否已经获得焦点，以及浏览器插件是否正常连接

常见问题

参考网页操作常见问题

指令说明​

指令输入参数​

指令输出参数​

快捷键格式说明​

AI生成流程注意事项​

Ctrl+A 示例​

按下 Enter 示例​

类型定义参考​

常见问题​