等待元素
等待元素
描述:等待指定元素存在或不存在
属性说明
拾取UIA模式:

常规属性
目标属性
- 等待状态 - 指定等待元素的状态。可选值:等待元素出现、等待元素消失
- 等待超时(秒) - 设置等待超时时间,单位为秒,设置为负数时表示无限等待
返回值
- 输出到变量 - 返回布尔值表示等待是否成功,True表示等待条件满足,False表示等待超时或失败
高级属性
通用属性
- 前置延时 - 组件功能执行之前等待的时间,单位为“毫秒”
- 后置延时 - 组件功能执行后等待的时间,单位为“毫秒”
- 备注- 组件备注说明,以便于理解和快速定位
目标属性
- 路径 - 元素定位的路径
窗口属性
- 标题 - 记录拾取的控件所在的窗口标题信息,可__*__号匹配
- 类 - 辅助标题的定位属性,可能存在多个相同标题,此时再判断类是否一致
- 类型 - 无效参数,已舍弃
拾取CS模式:

常规属性
目标属性
- 等待状态 - 指定等待元素的状态。可选值:等待元素出现、等待元素消失
- 等待超时(秒) - 设置等待超时时间,单位为秒,设置为负数时表示无限等待
返回值
- 输出到变量 - 返回布尔值表示等待是否成功,True表示等待条件满足,False表示等待超时或失败
高级属性
通用属性
- 前置延时 - 组件功能执行之前等待的时间,单位为“毫秒”
- 后置延时 - 组件功能执行后等待的时间,单位为“毫秒”
- 备注- 组件备注说明,以便于理解和快速定位
窗口属性
- 标题 - 记录拾取的控件所在的窗口标题信息,可__*__号匹配
- 类、位置、大小、类型、扩展类型、句柄 - 辅助标题的定位属性
目标属性
- 类、实例、类名、名字、高级、唯一标识、值、位置、大小、单击、类型、扩展类型、句柄 - 定位元素的属性
拾取SAP模式:

常规属性
目标属性
- 等待状态 - 指定等待元素的状态。可选值:等待元素出现、等待元素消失
- 等待超时(秒) - 设置等待超时时间,单位为秒,设置为负数时表示无限等待
返回值
- 输出到变量 - 返回布尔值表示等待是否成功,True表示等待条件满足,False表示等待超时或失败
高级属性
通用属性
- 前置延时 - 组件功能执行之前等待的时间,单位为“毫秒”
- 后置延时 - 组件功能执行后等待的时间,单位为“毫秒”
- 备注- 组件备注说明,以便于理解和快速定位
窗口属性
- 标题 - 记录拾取的控件所在的窗口标题信息
- 区域 - 仅记录拾取时元素大小参数
目标属性
- 名字、文本、类型、列名、行号、标识 - 定位元素的属性
拾取JAVA模式:

常规属性
目标属性
- 等待状态 - 指定等待元素的状态。可选值:等待元素出现、等待元素消失
- 等待超时(秒) - 设置等待超时时间,单位为秒,设置为负数时表示无限等待
返回值
- 输出到变量 - 返回布尔值表示等待是否成功,True表示等待条件满足,False表示等待超时或失败
高级属性
通用属性
- 前置延时 - 组件功能执行之前等待的时间,单位为“毫秒”
- 后置延时 - 组件功能执行后等待的时间,单位为“毫秒”
- 备注- 组件备注说明,以便于理解和快速定位
窗口属性
- 标题 - 窗口的名称
- 程序、类 - 定位元素的属性
目标属性
- 属性表、JVM应用名、JVM标题、JVM类名 - 定位元素的属性
拾取IE模式:

常规属性
目标属性
- 等待状态 - 指定等待元素的状态。可选值:等待元素出现、等待元素消失
- 等待超时(秒) - 设置等待超时时间,单位为秒,设置为负数时表示无限等待
返回值
- 输出到变量 - 返回布尔值表示等待是否成功,True表示等待条件满足,False表示等待超时或失败
高级属性
通用属性
- 前置延时 - 组件功能执行之前等待的时间,单位为“毫秒”
- 后置延时 - 组件功能执行后等待的时间,单位为“毫秒”
- 备注- 组件备注说明,以便于理解和快速定位
窗口属性
- 区域 - 仅记录拾取时元素大小参数
目标属性
- 查找模式 - 精确:只在当前网页查找拾取的元素 模糊:遍历全部网页查找拾取的元素
- 窗口标题 - 拾取元素的IE窗口标题,支持通配*
- 标签名 - 元素的标签
- 查找路径 - 元素的属性
- 标题 - 拾取元素的网页窗口标题
- 网址 - 拾取元素页面的url,支持通配*
拾取chrome、firefox、edge、360企业安全浏览器、360安全浏览器、360极速浏览器、360极速浏览器X、奇安信可信浏览器、紫鸟浏览器模式:

常规属性
目标属性
- 等待状态 - 指定等待元素的状态。可选值:等待元素出现、等待元素消失
- 等待超时(秒) - 设置等待超时时间,单位为秒,设置为负数时表示无限等待
返回值
- 输出到变量 - 返回布尔值表示等待是否成功,True表示等待条件满足,False表示等待超时或失败
高级属性
通用属性
- 前置延时 - 组件功能执行之前等待的时间,单位为“毫秒”
- 后置延时 - 组件功能执行后等待的时间,单位为“毫秒”
- 备注- 组件备注说明,以便于理解和快速定位
窗口属性
- 区域 - 拾取时元素的位置及大小
目标属性
- 标题 - 目标元素所在窗口的标题信息,支持通配*
- 网址 - 目标元素所在窗口的网址信息,支持通配*
- 索引 - 在找到的第几个元素上执行操作,一般为 0,即找到的第一个元素
- 类型名称 - 目标元素的类型名称
- 属性表 - 目标元素的 selector 或 xpath 属性,可双击或点击右侧按钮进入属性编辑模式
使用示例
场景示例
等待指定元素存在,然后获取该元素文本

步骤
1、添加【等待元素】组件--->等待状态参数选"等待元素出现"--->等待超时(秒)输入10s--->

2、点击【等待元素】组件的拾取按钮,拾取edge浏览器网页"https://support.i-search.com.cn/login"中以下元素--->

3、添加【IF分支】组件--->【IF分支】组件的"条件1"引脚连接【等待元素】的"返回值"引脚--->【IF分支】组件的"为真时"引脚后添加【获取文本】组件,"为假时"引脚后添加【Raise抛出异常】组件--->

4、【获取文本】组件,点击拾取按钮,拾取以下元素--->执行流程--->在流程开始执行的10s时间内,等待的元素出现

输出结果
edge浏览器的网页中,艺赛旗社区登录页面,在流程开始执行的10s时间内加载完成,等待条件匹配成功,返回值True。成功获取元素文本内容并返回,如下图:

