验证文案是否存在

验证文案是否存在 用于检查当前手机界面是否出现了指定的文字。它常用于断言页面是否跳转成功、提示是否弹出，结果以布尔值（true/false）保存到输出变量，供后续条件判断或断言使用。

指令标识：MobileVerifyTextPresent
指令类型：手机指令
指令描述：验证界面是否存在指定文案

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「验证文案是否存在」节点，填写目标文案并配置「将结果保存至」	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileVerifyTextPresent(text="登录成功", outKey="exists")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

操作后需要断言页面出现了预期文案（如「登录成功」「下单成功」）。
根据某段文字是否出现，决定后续走哪条分支。
等待并确认提示文案出现，作为流程的检查点。

使用前确认

当前流程已经连接并占用了一台可用的手机设备。
目标文案与界面显示一致（包括标点、空格）。
已规划好用于保存结果的输出变量名，便于后续节点引用。

可视化编排：从 0 到跑通

下面用一个常见场景演示：登录后验证页面是否出现「登录成功」。按 3 步即可跑起来：

在工作流画布中添加 验证文案是否存在 指令，放在被检查操作之后。
在右侧配置面板的文案中填写要校验的文字，例如 登录成功；在 将结果保存至 中填写变量名，例如 loginOk。
点击运行，确认输出变量为 true/false，再在后续条件节点中引用做断言或分支。

【图片占位 | command-mobileverifytextpresent-config】
截图内容建议： 截一张可视化编排页面，画布选中「验证文案是否存在」节点，右侧属性面板展示「文案」「超时时间」「将结果保存至」三个区域。
标注建议： 用 ① 标出画布中的节点，用 ② 标出「文案」输入框，用 ③ 标出「超时时间」，用 ④ 标出「将结果保存至」。
用户看完应能明白： 核心是填写要校验的文案，结果以布尔值保存到输出变量。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
文案	`text`	String	是	-	要校验是否存在的文本内容，填写界面上显示的文字。
超时时间	`timeout`	Number	否	`5000`	等待文案出现的最大时间，单位毫秒。在该时间内出现即判定为存在。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	String	否	保存校验结果，布尔值：文案存在为 `true`，不存在为 `false`。

成功标准

验证文案是否存在 节点运行结束后状态为成功。
运行日志中没有参数缺失、超时或执行失败等错误。
如果配置了输出变量，后续节点能够读取到符合预期的结果。
后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 `Mobile device not configured`	流程未连接设备	先执行连接/占用设备节点，或在全局变量中配置设备上下文
结果总是 `false`	文案未渲染 / 文字不完全匹配	适当调大超时时间；确认文案与界面显示完全一致
结果意外为 `true`	文案在页面其他位置出现	使用更精确、唯一的文案，或改用验证元素存在按选择器校验
输出变量为空	未配置「将结果保存至」	检查是否填写了 `outKey`，并确认后续引用的变量名一致

Python 代码编排

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

# 验证界面是否存在「登录成功」，结果保存到变量 loginOk
bots.mobileVerifyTextPresent(text="登录成功", outKey="loginOk")

如需延长等待文案出现的时间，可调整超时：

bots.mobileVerifyTextPresent(
    text="下单成功",
    timeout=15000,
    outKey="orderOk",
)

可视化表单里的「文案」「超时时间」「将结果保存至」分别对应代码里的 text、timeout、outKey。

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

常见问题

Q1：找不到文案会报错吗？

A：不会抛错。该指令把校验结果以布尔值写入输出变量，找不到时为 false，由你在后续节点决定如何处理。

Q2：和「验证元素存在」有什么区别？

A：本指令按可见文字校验，更直观；验证元素存在按选择器校验，定位更精确，适合文字不唯一的场景。