点击元素（推荐）

点击元素（推荐） 用于点击网页中的按钮、链接、菜单、分页、列表项等元素。使用方式和商业 RPA 产品里的 Click/Recorder Capture 类似：先捕获目标元素，再配置点击方式。

指令标识：ClickElementMixed
指令类型：网页指令
指令描述：点击网页中的按钮、链接或其他元素，支持鼠标键、点击次数、辅助按键和下载场景输出

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。点击元素 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「点击元素」节点，捕获目标元素、设置点击方式	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 bots.clickElementMixed(selector="...", button="LEFT")	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

• 点击登录、提交、查询、下载等按钮。
• 点击导航菜单、分页、筛选项或列表项。
• 点击后打开弹窗、新页面或触发页面刷新。

如果只是要打开一个网址，请使用 打开网页 或 导航到 URL；如果要输入内容，请使用 输入文本。

使用前确认

• 目标页面已经加载完成。
• 目标元素已经存在，必要时先使用等待节点。
• 捕获元素前，浏览器处在该节点运行时应有的页面状态。
• 如果元素在 iframe、弹窗或新窗口中，请确认上下文正确。
• 高风险按钮，例如支付、审批、删除、提交订单，需要先增加人工确认或保护条件。

可视化编排：从 0 到跑通

1. 确认页面已经打开，并且目标按钮或链接可见。
2. 在点击前添加 等待元素存在。
3. 捕获要点击的目标元素。
4. 配置鼠标键、点击次数和定位超时。
5. 运行后观察页面是否跳转、弹窗是否出现或列表是否刷新。

最小示例

一个常见浏览器 RPA 片段：

1. 打开网页：进入目标网站。
2. 等待元素存在：等待“校园招聘”入口出现。
3. 点击元素：点击目标入口按钮。
4. 等待元素存在：等待职位列表区域出现。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
元素选择器	selector / target	String	是	-	用于定位要点击的网页元素。建议从元素库捕获。
鼠标键	clickOptions.button	Enum	否	LEFT	支持 LEFT、RIGHT、MIDDLE。
点击次数	clickOptions.clickCount	Integer	否	1	设置为 2 可实现双击。
辅助按键	clickOptions.modifiers	List<Enum>	否	-	点击时同时按下 ALT、CONTROL、META、SHIFT。
横坐标	clickOptions.position.x	Number	否	-	相对元素左上角的点击偏移。
纵坐标	clickOptions.position.y	Number	否	-	相对元素左上角的点击偏移。
iframe 页面定位器	frameSelector	String	否	-	目标元素在 iframe 中时填写。
查找元素高级配置	findElementOptions	JSON	否	-	高级 JSON 选项，可在其中设置查找元素的等待时间等，例如 {"timeout":5000}。

输出参数

普通点击通常不需要配置输出。若配置 outKey，会保存被点击元素的信息；若点击触发下载，并配置了下载相关参数和 outKey，会保存下载文件信息。多数场景建议通过后续等待节点或页面状态判断点击是否成功。

成功标准

• 点击节点执行成功。
• 页面出现预期变化，例如跳转、弹窗、列表刷新或按钮状态变化。
• 后续等待节点能找到点击后的目标元素。

失败排查

现象	可能原因	处理建议
节点报错：找不到目标元素（定位超时 / 元素未找到）	页面没加载完成或定位失效	点击前先加等待元素，确认元素已出现再点击
点击没反应	元素被遮罩、动画未结束、点击位置不对	等待动画结束，滚动到可见区域，必要时设置偏移
点到了错误位置	捕获时页面状态和运行时不同	回到运行时页面状态重新捕获
点击后后续节点失败	页面跳转未完成	点击后增加等待页面或等待元素节点

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

bots.openUrl(url="https://example.com")

# 点击目标元素：button / clickCount 可直接作为参数传入
bots.clickElementMixed(
    selector="//*[@id='__next']/div[1]/nav/ul/li[2]/a",
    button="LEFT",
    clickCount=1,
)

如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。

常见问题

Q1：为什么推荐使用这个点击指令？

A： 这个指令是当前浏览器 RPA 中的推荐点击入口，支持鼠标键、点击次数、辅助按键、点击偏移和下载场景输出，适合大多数网页点击操作。

Q2：如果元素不存在会怎样？

A： 默认会报错。找不到目标元素时引擎会先尝试自愈，仍然找不到就抛出元素定位错误，节点失败、流程中断。只有把节点的「失败处理」设为「可选」或「继续」时，才会跳过本次点击并继续执行后续节点。无论哪种方式，都建议在点击前用 等待元素存在 或 验证元素存在 先确认元素已经出现。

Q3：该指令支持哪些鼠标按键？

A： 支持以下鼠标按键：

• LEFT：左键（默认）
• RIGHT：右键
• MIDDLE：中键滚轮

Q4：如何实现双击效果？

A： 将 点击次数 参数设置为 2 即可实现双击效果。

Q5：点击后打开新页面或弹窗怎么办？

A： 点击后建议紧接一个等待节点，等待新页面或弹窗中的关键元素出现。这样比只判断点击节点成功更可靠。

相关指令

• 浏览器自动化指令入门
• 验证元素存在
• 等待元素存在
• 输入文本
• 获取文本