验证文本是否存在

验证文本是否存在 用于检查当前页面是否能找到指定文本，并把结果（存在为真、不存在为假）保存到变量。它常用于断言操作是否成功，例如确认页面出现「提交成功」「保存成功」等提示。

指令标识：VerifyTextPresent
指令类型：网页指令
指令描述：验证页面是否存在指定文本

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「验证文本是否存在」节点，填写待验证文本、设置输出变量	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 bots.verifyTextPresent(text="提交成功", outKey="ok")	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

• 操作完成后，验证页面是否出现成功提示。
• 检查页面是否包含某个关键词、状态或标识。
• 作为流程中的断言点，判断是否继续后续步骤。

如果你要验证页面 不存在 某段文本，请使用 验证文本不存在；如果是要把文本内容读出来，请使用 获取文本。

使用前确认

• 页面已经进入待验证的状态，目标文本应该已经渲染，必要时先用等待节点。
• 已经确认要验证的文本内容（注意空格、标点、大小写）。
• 已经规划好输出变量名。
• 需要正则匹配时，先确认表达式。

可视化编排：从 0 到跑通

下面用一个常见场景演示：提交后验证页面出现「提交成功」。

1. 完成提交操作后，确认页面进入结果状态。
2. 在验证前可先用 等待元素存在 等待结果区域出现。
3. 添加 验证文本是否存在 节点，待验证文本 填写 提交成功。
4. 在 将结果保存至 填写变量名，例如 submitOk。
5. 运行后查看变量值是否为真。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
待验证文本	text	String	是	-	要在页面上查找的文本。
是否为正则表达式	isRegex	String	否	-	为 true 时把待验证文本当作正则表达式匹配。
验证文本配置项	waitForSelectorOptions	JSON	否	-	高级选项。JSON 配置，用于设置查找等待相关选项。
False结果处理	falseResultHandling	Enum	否	OUTPUT_RESULT	验证结果为 False 时的行为：OUTPUT_RESULT(输出结果，继续流程)、THROW_EXCEPTION(抛出异常，中断流程)
是否发送消息	sendMsgFlag	Boolean	否	True	是否发送节点消息

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	outKey	Boolean	否	保存验证结果，存在为真、不存在为假。

成功标准

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

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 text 不能为空	待验证文本为空	填写「待验证文本」；代码编排确认 text 已传入
结果为假但文本明明在页面上	文本还没渲染、被空格/标点干扰，或在 iframe 中	验证前先等待文本出现；核对文本是否完全一致
结果为假时流程中断	失败结果处理设置为抛出断言失败	如不希望中断，调整「失败结果处理」配置
正则没匹配上	表达式写法不对	先用普通文本验证调通，再改用正则

Python 代码编排

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

# 验证页面是否出现“提交成功”
ok = bots.verifyTextPresent(text="提交成功", outKey="submitOk")
print(ok)

使用正则匹配：

bots.verifyTextPresent(
    text="共\\d+条记录",
    isRegex="true",
    outKey="hasRecords",
)

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

常见问题

Q1：验证结果保存的是什么？

A： 一个布尔值。页面存在该文本为真，不存在为假。

Q2：验证结果为假会中断流程吗？

A： 取决于「失败结果处理」配置。设置为抛出断言失败时，结果为假会让节点失败、流程中断；否则只是把结果保存为假并继续。

Q3：为什么文本在页面上却验证为假？

A： 常见原因是文本还没渲染、含有不可见空格、大小写或标点不一致，或文本在 iframe 中。建议先用等待节点，并核对文本是否完全一致。

相关指令

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