等待 URL 变化

📖 节点概述

用来等待浏览器地址栏的 URL 满足特定条件。你可以在表单提交、页面跳转或单页应用路由变化后，用此节点确认是否到达了预期的页面。支持包含、不包含、正则、相等、开头、结尾等多种匹配方式，同时具备超时重试和失败分支，避免流程因页面跳转延迟而中断。

💡 使用场景：

• 等待登录成功后的跳转：点击登录后，等待 URL 包含 /dashboard 或 /home，再继续操作。
• 确认表单提交后的反馈页面：提交订单后，等待 URL 中包含 success 或 orderId 参数。
• 单页应用路由监听：在 Vue/React 应用中等待特定路由的出现，例如 #/result。
• 防止过早操作：有些页面会先跳转到一个中间过渡页，再重定向到末尾页，使用此节点可以精确等待末尾页面的 URL 出现。
• 正则匹配复杂参数：如果 URL 中包含动态变化的 token 或 ID，可以用正则匹配，例如 /order/\d+。

🎮 实战连线指南：如何正确使用它？

节点串联在执行流中。它会在后台不断检查当前页面的 URL，直到满足你设定的条件，或者超过最大等待时间。如果满足条件，流程从“成功”出口继续；如果超时，则从“失败”出口分流（也可选择抛出异常）。

场景案例：点击“登录”按钮后等待跳转到后台首页

1. 点击登录按钮：使用【点击元素】节点提交登录表单。
2. 配置等待条件：将点击的 Exec 输出连接到【等待 URL 变化】的 Exec 输入。
   • “条件模式”选择 包含 (contains)。
   • “目标URL片段”填入 dashboard。
3. 设置超时：高级选项中“超时(ms)”设为 10000（10 秒），重试次数 1，即最多等 20 秒。
4. 连接分支：
   • 将 成功 出口连接到后续的后台操作节点。
   • 将 失败 出口连接到错误处理（如截图、通知管理员）。
5. 执行：流程会自动等待页面跳转到包含 dashboard 的地址，超时则进入错误处理。

场景案例：使用正则匹配动态订单详情页

1. 设置条件：“条件模式”选择 正则匹配 (regex)，“目标URL片段”填入 /order/\d+/detail。
2. 提供原始 URL（可选）：如果你想严格对比与当前 URL 的变化，可以从前一个【获取页面信息】节点连出 URL 引脚到本节点的 原始URL。否则节点会自动获取当前地址作为基准。
3. 运行：当 URL 匹配到类似 /order/12345/detail 时，节点立即放行。当前URL 引脚同时输出完整的匹配地址，方便后续提取订单 ID 等参数。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

💎 小贴士：

• 如果页面是 SPA 应用，URL 可能只改变哈希部分（#），本节点依然能检测到，因为它监控的是完整的 window.location.href。
• 可以配合“获取页面信息”节点使用：先用“获取页面信息”得到初始 URL，传入 原始URL，再等待新的 URL 出现，这在需要严格对比变化的场景下非常有用。
• 正则模式请使用完整的正则表达式语法，例如 \d+ 匹配数字，不需要加引号或前后斜杠（除非你的正则包含特殊字符，节点会自动处理）。
• 适当减少“间隔”值可以更快捕获瞬间的 URL 变化，但会增加 CPU 开销，一般 200ms 是平衡的选择。