导航到 URL
导航到 URL 用于让当前浏览器页面跳转到指定网址。它适合在浏览器已经打开后继续访问另一个页面，通常会复用当前浏览器会话、Cookie 和登录状态。
指令标识：NavigateToUrl
指令类型：网页指令
指令描述：在当前浏览器实例中导航到指定的网址，如果当前没有页面则会新建一个页面
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。导航到 URL 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「导航到 URL」节点，在表单里填写目标网址、超时等 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.navigateToUrl(rawUrl="https://example.com") | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。
什么时候用？
Section titled “什么时候用？”- 已经打开浏览器，需要在同一会话中进入另一个页面。
- 登录后跳转到后台列表页、详情页或配置页。
- 保留当前 Cookie、登录态和浏览器上下文继续操作。
- 当前没有页面时，也希望自动创建页面并打开目标 URL。
如果这是流程的第一步，优先使用 打开网页；如果只是点击页面上的链接或按钮，优先使用 点击元素。
- 当前浏览器会话是你希望复用的会话。
- 目标 URL 可访问，建议包含
http://或https://。 - 跳转后页面是否需要登录态、权限或特定环境。
- 跳转后要用哪个关键元素判断页面真正就绪。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”- 先使用 打开网页 建立浏览器上下文，或确认当前已有可用页面。
- 添加 导航到 URL 指令。
- 在 导航到的网址 中填写目标地址，例如：
https://example.com/search一个登录后跳转到列表页的流程可以这样配置：
- 打开网页：打开系统入口页。
- 等待元素存在：等待登录成功后的导航菜单出现。
- 导航到 URL：跳转到列表页或详情页。
- 等待元素存在：等待列表容器出现。
- 获取文本：读取列表数量或状态。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| 导航到的网址 | rawUrl / url / value | String | 是 | - | 要跳转的目标网页地址。建议填写完整协议，例如 https://example.com/search。 |
| 超时时间 | timeout / navigateOptions.timeout | Number | 否 | 60000 | 导航等待的最长时间，单位毫秒。 |
| 成功状态 | waitUntil / navigateOptions.waitUntil | Enum | 否 | LOAD | 页面导航完成判断方式。支持 LOAD、DOMCONTENTLOADED、NETWORKIDLE、COMMIT。 |
该指令没有业务输出变量，主要作用是改变当前页面地址。是否成功应通过页面地址、运行日志和后续等待节点判断。
和“打开网页”的区别
Section titled “和“打开网页”的区别”| 指令 | 适合场景 | 用户理解 |
|---|---|---|
| 打开网页 | 流程第一步，启动浏览器并打开入口页 | “从这里开始” |
| 导航到 URL | 浏览器已经打开，要在当前会话里跳转 | “继续去另一个页面” |
- 当前页面地址变为目标 URL，或进入目标 URL 对应页面。
- 运行日志中没有导航超时、网络或权限错误。
- 后续等待页面或等待元素节点能继续执行。
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 跳转失败 | URL 错误、网络不可达、环境无权限 | 先手动打开目标 URL，确认网络和权限 |
| 跳到登录页 | 登录态失效或当前会话不对 | 先完成登录，或检查浏览器会话是否被复用 |
| 导航超时 | 页面加载慢或目标站点响应慢 | 调大超时时间，或使用更合适的成功状态 |
| 跳转成功但后续找不到元素 | 页面内容仍在异步加载 | 跳转后增加等待元素存在 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 先打开浏览器bots.openUrl(url="https://example.com")
# 在当前会话中跳转到另一个地址bots.navigateToUrl(rawUrl="https://example.com/search", timeout=30000)如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：导航到的网址参数是必填项吗？
Section titled “Q1：导航到的网址参数是必填项吗？”A： 是的。需要提供目标 URL。建议填写完整协议（http:// 或 https://），省略协议时运行时会自动补 http://。
Q2：如果当前没有活动页面会怎样？
Section titled “Q2：如果当前没有活动页面会怎样？”A： 如果当前没有活动页面，指令会自动创建一个新页面进行导航，这样可以确保操作的连续性。
Q3：导航过程中发生超时会怎样？
Section titled “Q3：导航过程中发生超时会怎样？”A： 导航过程中如果发生超时等异常，节点会失败。建议先确认目标站点可访问，再根据页面速度设置合适的超时时间。
Q4：该指令会保持已有的登录状态吗？
Section titled “Q4：该指令会保持已有的登录状态吗？”A： 是的。该指令会在当前浏览器会话中执行导航，保持已有的登录状态、Cookie等会话信息。