验证图片存在

这是一个用于在移动设备上验证特定图片在手机当前屏幕是否存在的指令，输出验证结果（True或False）。你可以通过元素选择器来定位目标图片元素,并验证该元素是否存在于当前页面中。当需要验证某个图片元素是否存在时,使用该指令。

指令标识：MobileVerifyImagePresent
指令类型：移动端指令
指令描述：验证特定图片在手机当前屏幕是否存在，输出验证结果（True或False）

可视化编排：从 0 到跑通

验证图片元素是否存在于手机当前屏幕界面。

参数说明

输入参数

参数名	类型	必填	默认值	说明
图片S3地址	String	是	-	图片的S3 url地址
对比图片相似度	Double	否	-	设置要验证图片相似度
False结果处理	String	否	`输出结果`	False结果处理方式，可选值：`输出结果`、`抛出异常`

输出参数

参数名	类型	必填	默认值	说明
将结果保存至	Boolean	是	-	输出指令的结果，输出`True`或`False`

什么时候用？

1. UI元素图像验证 通过图像识别验证UI元素是否正确显示，适用于难以通过选择器定位的元素。适用于自动化测试中的断言、结果校验、流程分支判断等场景。

2. 验证图标或按钮显示 验证特定图标或按钮是否在页面上显示，确认UI渲染正确。适用于自动化测试中的断言、结果校验、流程分支判断等场景。

3. 检查加载完成状态 验证加载完成图标是否出现，确认页面或数据加载完成。该场景常用于异步数据加载、页面渲染等待、动态内容展示等自动化测试流程，确保页面内容完整可用。

4. 验证错误提示图标 验证错误提示图标是否显示，确认错误状态正确展示。适用于自动化测试中的断言、结果校验、流程分支判断等场景。

5. 广告或横幅验证 验证广告图片或横幅是否正确显示在页面上。适用于自动化测试中的断言、结果校验、流程分支判断等场景。

代码编排

可使用执行指令（XML）节点动态调用该指令。

XML 示例

通过执行指令，编写XML代码调用

<MobileVerifyImagePresent
    imageFilePath="your_image_s3_url"
    similarityValue="0.9"
    falseResultHandling="OUTPUT_RESULT"
    outKey="output"
    />

常见问题

Q1：两个参数都是必填的吗？

A： imageFilePath和outKey是必填参数。相似度阈值默认为0.9（90%），可根据实际需求调整。

Q2：支持哪些图片格式？

A：支持常见的图片格式（如PNG、JPG、JPEG等），建议使用无损格式（PNG）以获得更准确的识别结果。

Q3：文件路径有什么要求？

A： imageFilePath必须是有效的S3地址，确保文件存在且可访问。需要确保网络连接正常，能够访问S3存储服务。

Q4：相似度阈值如何设置？

A：相似度越高，匹配要求越严格。建议使用清晰、适当尺寸的图片作为识别目标，过大或过小的图片可能影响识别效果。不同设备的屏幕分辨率可能影响识别结果，建议针对目标设备准备合适的图片素材。

Q5：False结果处理如何使用？

A：该参数用于控制验证失败场景下的执行行为，支持两种策略（括号内为需传入的参数值）：

输出结果（OUTPUT_RESULT，默认）：验证失败时输出 false 结果到 outKey，继续执行后续流程。

抛出异常（THROW_EXCEPTION）：验证失败时抛出异常，中断当前流程执行。