清除文本

清除文本 用于清空一个输入框或文本域里的已有内容。它常用在重新填写之前，先把旧值清掉，避免新内容追加在旧内容后面。

指令标识：ClearText
指令类型：网页指令
指令描述：清除输入框中的文本内容

先选使用方式

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

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

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

什么时候用？

• 重新填写表单前，先清空输入框里残留的旧值。
• 搜索框里有默认词或上次的关键词，需要先清空再输入。
• 多次循环填表，每轮开始前清空字段。

如果你只是要输入新内容，可以直接使用 输入文本。需要先清空再输入时，先用本指令再用输入文本。

使用前确认

• 目标输入框已经出现并可编辑，必要时先用等待节点。
• 捕获的是可编辑元素（input / textarea 等），不是普通文本节点。
• 如果元素在 iframe 中，请配置 iframe 页面定位器。

可视化编排：从 0 到跑通

下面用一个常见场景演示：清空搜索框，再输入新的关键词。

1. 确认页面已经打开，搜索框可见。
2. 在清除前添加 等待元素存在，等待搜索框出现。
3. 添加 清除文本 节点，捕获搜索框。
4. 在其后添加 输入文本，输入新的关键词。
5. 运行后确认搜索框中只有新关键词，没有残留旧内容。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
元素选择器	selector	String	是	-	要清空的输入框元素。建议从元素库捕获。
清除文本选项	option	JSON	否	-	高级选项。JSON 配置，用于设置清除文本的相关行为。
iframe 页面定位器	frameSelector	String	否	-	高级选项。目标输入框在 iframe 中时填写。
查找元素高级配置	findElementOptions	JSON	否	-	高级选项。JSON 配置，可设置查找元素的超时等待等选项。
是否发送消息	sendMsgFlag	Boolean	否	True	是否发送节点消息。

输出参数

该指令没有输出变量。底层通过把输入框的值设置为空字符串实现清空。

成功标准

• 清除文本 节点运行结束后状态为成功。
• 运行日志中没有参数缺失、超时或执行失败等错误。
• 后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

现象	可能原因	处理建议
节点报错：找不到目标元素（定位超时 / 元素未找到）	页面没加载完成或定位失效	清除前先加等待元素，确认输入框已出现。默认找不到元素会报错、节点失败；仅当节点「失败处理」设为「可选 / 继续」才会跳过
清空没生效	选中的不是可编辑输入框	重新捕获真正的 input / textarea 元素
清空后又出现旧内容	页面自动回填或有默认值	在清空后立即输入新值，或排查页面回填逻辑

Python 代码编排

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

# 先清空搜索框，再输入新关键词
bots.clearText(selector="//*[@id='search']/input")
bots.fillText(selector="//*[@id='search']/input", text="新关键词")

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

常见问题

Q1：清除文本和输入文本有什么区别？

A： 清除文本只负责把输入框清空；输入文本负责填入新内容。需要替换内容时，先清除再输入更稳妥。

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

A： 默认会报错（经自愈仍找不到则抛错、节点失败）。只有把节点「失败处理」设为「可选 / 继续」时才会跳过本次清除。建议清除前先用 等待元素存在 确认元素已出现。

相关指令

• 浏览器自动化指令入门
• 输入文本
• 等待元素存在
• 发送按键