清除文本

清除文本 用于在移动端（Android / iOS / Harmony）通过元素选择器定位目标输入框，并清空其中已有的文本内容，常见于清空搜索框、重置表单输入、清除聊天输入等场景。

指令标识：MobileClearText
指令类型：移动端指令
指令描述：在移动设备上清除指定文本输入框的内容

先选使用方式

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

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

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

什么时候用？

在重新输入前，先清空输入框原有内容。
清空搜索框的历史关键词，准备新的搜索。
重置表单中某个输入项。

清空后通常会接输入文本重新填入新内容。

使用前确认

目标元素是可编辑的输入框（如 EditText），且当前可见、可交互。
已准备好稳定的元素选择器（id、xpath、text、accessibilityId 等）。
该指令属于元素定位类，默认失败即中止（报错中止）：在超时时间内找不到元素会抛出异常。
iOS 安全输入框（SecureTextField）可能不支持直接清除，需配合输入文本做全选删除。

【图片占位 | command-mobilecleartext-config】
截图内容建议： 截一张可视化编排页面，画布选中「清除文本」节点，右侧属性面板展示「元素选择器」与高级区的「超时时间」。
标注建议： 用 ① 标出节点，用 ② 标出元素选择器，用 ③ 标出超时时间，用 ④ 标出运行按钮。
用户看完应能明白： 这个指令主要选中目标输入框，超时时间为按需高级项。

可视化编排：从 0 到跑通

下面用一个常见场景演示：清空搜索框，准备输入新的关键词。按 4 步即可跑起来：

在前序流程中打开 App 并进入含搜索框的页面。
添加 清除文本 节点，在 元素选择器 中选择或填写搜索框定位：

//*[@resource-id='search_input']

如设备响应较慢，可在高级区适当调大 超时时间。
点击运行，确认搜索框内容已被清空，再接输入文本填入新内容。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
元素选择器	`selector`	String	是	-	元素定位方式，如 `id`、`xpath`、`text`、`accessibilityId` 等，不能为空
超时时间	`timeout`	Integer	否	`10000`	高级选项。查找元素的最大等待时间（毫秒），为大于 0 的整数，最大不超过 `60000`

输出参数

无。

成功标准

目标输入框中的文本被清空，显示为空。
运行日志中没有 ELEMENT_NOT_FOUND 等错误。

运行后你会看到（以上面场景为例）：

搜索框内容被清空，可继续输入新的搜索关键词。

失败排查

现象 / 报错原文	可能原因	处理建议
返回 `ELEMENT_NOT_FOUND`	选择器未匹配到元素或元素未加载	核对选择器，适当调大 `timeout`，确认页面已加载
清除操作失败	目标元素不可编辑	确认元素是可编辑输入框（如 `EditText`）
iOS 安全输入框清不掉	安全输入框不支持直接清除	配合输入文本执行全选 + 删除
超时报错	设备或页面响应较慢	在 `0` 到 `60000` 范围内调大 `timeout`

Python 代码编排

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

# 清空搜索框内容
bots.mobileClearText(selector="//*[@resource-id='search_input']")

如设备响应较慢，可调大超时时间：

bots.mobileClearText(
    selector="//*[@resource-id='search_input']",
    timeout=10000,
)

可视化表单里的「元素选择器」「超时时间」分别对应代码里的 selector、timeout。

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

常见问题

Q1：哪些元素可以清除文本？

A：只能对可编辑元素（如 EditText）使用。元素不存在或不可编辑时操作会失败。

Q2：iOS 安全输入框如何处理？

A：某些安全输入框（SecureTextField）不支持直接清除，需配合输入文本执行全选 + 删除，建议先确认元素类型。

Q3：超时时间如何设置？

A： timeout 为大于 0 的整数，最大不超过 60000 毫秒。建议结合设备性能和网络情况调整。