验证文本不存在

验证文本不存在 用于检查当前页面是否 没有 出现指定文本，并把结果（不存在为真、存在为假）保存到变量。它常用于断言异常未发生，例如确认页面没有出现「错误」「失败」等提示。

指令标识：VerifyTextNotPresent
指令类型：网页指令
指令描述：验证页面不存在指定文本

先选使用方式

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

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

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

什么时候用？

• 操作完成后，验证页面没有出现错误或失败提示。
• 确认某个异常文本、警告标识没有出现。
• 作为流程中的断言点，确认「不该出现的内容」确实没出现。

如果你要验证页面 存在 某段文本，请使用 验证文本是否存在。

使用前确认

• 页面已经进入待验证状态，且已稳定（如果文本会延迟出现，过早验证可能误判为不存在）。
• 已经确认要验证的文本内容（注意空格、标点、大小写）。
• 已经规划好输出变量名。
• 需要正则匹配时，先确认表达式。

可视化编排：从 0 到跑通

下面用一个常见场景演示：提交后验证页面没有出现「失败」。

1. 完成提交操作，等待页面稳定。
2. 添加 验证文本不存在 节点，待验证文本 填写 失败。
3. 在 将结果保存至 填写变量名，例如 noFail。
4. 运行后查看变量值是否为真（为真表示页面没有出现「失败」）。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
待验证文本	text	String	是	-	要确认页面上不存在的文本。
是否为正则表达式	isRegex	String	否	-	高级选项。为 true 时把待验证文本当作正则表达式匹配。
验证文本配置项	waitForSelectorOptions	JSON	否	-	高级选项。用于设置查找等待相关选项。
False结果处理	falseResultHandling	Enum	否	OUTPUT_RESULT	高级选项。验证结果为「假」（即文本存在）时的处理方式：OUTPUT_RESULT（输出结果）、THROW_EXCEPTION（抛出异常）。

输出参数

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

成功标准

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

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 text 不能为空	待验证文本为空	填写「待验证文本」；代码编排确认 text 已传入
文本会延迟出现，却被判为不存在	验证太早，文本还没渲染	在验证前适当等待，确保页面稳定后再验证
结果为假时流程中断	文本存在且失败结果处理设置为抛出断言失败	如不希望中断，调整「失败结果处理」配置
正则匹配结果不符合预期	表达式写法不对	先用普通文本验证调通，再改用正则

Python 代码编排

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

# 验证页面没有出现“失败”
no_fail = bots.verifyTextNotPresent(text="失败", outKey="noFail")
print(no_fail)

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

常见问题

Q1：结果为真代表什么？

A： 代表页面上确实没有找到指定文本（验证通过）。文本存在时结果为假。

Q2：会不会因为文本还没加载就误判为不存在？

A： 有可能。如果目标文本是延迟出现的，过早验证会得到「不存在」的结果。建议在验证前等待页面稳定。

相关指令

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