极奇策RPA技术教程:等待页面加载完成 (NodeWaitPageLoad) - 自动化开发与配置详细指南

等待页面加载完成
📖 节点概述
在执行后续操作之前,确保页面已经达到可交互或完全加载状态。你可以选择等待 DOM 结构解析完成(interactive)或等待所有图片、样式等资源均加载完毕(complete)。节点会周期性检查页面状态,并提供超时重试机制。若加载超时,可自动转入失败处理分支,避免流程一直等待。
💡 使用场景:
- 页面跳转后等待:导航到新网址后,立即使用此节点确保页面内容已加载,然后再进行元素定位和点击。
- AJAX 内容就绪:等待动态内容初步渲染完成(DOM 可交互),再抓取通过脚本生成的数据。
- 资源密集型页面:对于包含大量图片或外部嵌入内容的页面,可启用“等待所有资源”,确保所有媒体就绪后再截图或进行视觉检测。
- 避免过早操作:防止在页面白屏或元素尚未出现时就开始操作而导致的元素定位失败。
🎮 实战连线指南:如何正确使用它?
节点默认操作当前活动标签页,也可通过 Tab 指定其他标签页。它提供两个执行出口:成功 和 失败。你通常会将前一个动作的 Exec 连接到本节点,然后将 成功 出口连接后续正常操作,失败 出口连接重试或通知逻辑。
场景案例:登录后等待首页完全加载再继续
- 点击登录按钮:使用【点击元素】提交登录表单。
- 等待加载:将点击的
Exec输出连接到【等待页面加载完成】的Exec输入。条件模式选择页面完全加载 (load),并保持“等待所有资源”关闭(除非首页有大量图片必须全部显示)。 - 分支处理:
- 将
成功出口连接到后续操作,如【获取页面信息】或【点击元素】进入个人中心。 - 将
失败出口连接到【显示通知】节点,提示“首页加载超时,请检查网络或重试”。
- 将
- 超时设置:在高级选项中,可以根据页面复杂度调整“超时(ms)”和“重试次数”。默认 15 秒超时,重试 2 次,即最长等待 45 秒。
场景案例:等待动态加载的列表数据出现(DOM可交互)
- 访问页面:导航到包含异步加载数据的列表页。
- 等待 DOM 就绪:条件模式选择
DOM 可交互。这意味着只要 HTML 结构解析完毕,即使部分图片还在加载,节点就会放行。 - 成功放行:由于列表数据通常是通过 JS 插入的,DOM 可交互后,列表容器很可能已经存在。
成功出口可直接连接【判断元素是否存在】或【提取表格数据】等节点。 - 超时重试:如果网络较慢,可适当增加超时时间和重试间隔。
⚙️ 引脚与参数说明
📥 输入引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | 控制流入口,触发后开始等待页面加载。 |
| Tab | TAB | (可选) 指定要等待的标签页,不连则使用当前活动标签页。 |
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 条件模式 | 下拉选择 | 页面完全加载 (load):等待 document.readyState 变为 complete,并可选择是否等待所有资源。<br>DOM 可交互:只需 readyState 达到 interactive 或 complete,速度更快。 |
| 所有资源加载完毕 | 开关 | (高级,仅在“页面完全加载”模式下可见) 开启后,除了等待 complete 状态,还会确认所有资源(如图片、脚本)均已加载完毕,没有挂起的请求。 |
| 超时(ms) | 数字 | (高级) 单次等待的最长时间(毫秒)。超过时间后,若未满足条件,将根据重试次数进行下一次等待或最终判定失败。 |
| 间隔(ms) | 数字 | (高级) 检查页面状态的频率。间隔越短,反应越快,但会增加少量 CPU 开销。 |
| 重试 | 数字 | (高级) 超时后的重试次数。总等待时间 = 超时 × (重试次数 + 1)。设为 0 表示不重试。 |
| 异常走失败端口 | 开关 | (高级) 开启后,在发生超时或无法获取页面状态时,不会抛出异常中断流程,而是自动走“失败”出口。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| 成功 | EXEC | 条件满足(页面加载完成)时触发。 |
| 失败 | EXEC | 超时未能满足条件时触发(仅在开启“异常走失败端口”时有效,否则报错)。 |
| 当前状态 | STRING | 末尾页面的readyState 值,例如 "complete"。 |
| 是否超时 | BOOL | True 表示等待超时或失败,False 表示成功。 |
💎 小贴士:
- 如果页面在加载过程中触发了重定向,本节点会跟随重定向并在新页面上检测状态,无需额外处理。
- “DOM 可交互”模式特别适合单页应用(SPA),因为此时页面框架已经挂载,后续的元素大概率已存在。
- 设置过长的超时时间可能会让流程挂起很久,建议根据实际页面的平均加载时间设置一个合理的值,并利用重试机制来应对偶尔的网络波动。
- 可以在流程中多次使用本节点,例如先等待 DOM 可交互后做一部分快速操作,再等待完全加载以处理图片。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

