网页前进
网页前进 用于让当前浏览器页面前进到历史记录中的下一页，效果类似点击浏览器前进按钮。它通常和 网页后退 配合使用，用于在浏览器历史记录中来回切换页面。
指令标识：ForwardPage
指令类型：网页指令
指令描述：模拟浏览器的前进操作，导航到浏览器历史记录中的下一页
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。网页前进 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「网页前进」节点，按需设置超时时间和成功状态 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.forwardPage()（如需自定义超时/成功状态，传入 goForwardOptions） | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。
什么时候用？
Section titled “什么时候用？”- 执行网页后退后，需要回到刚才的页面继续操作。
- 在列表页和详情页之间通过浏览器历史记录来回切换。
- 验证网页的前进/后退历史记录是否符合预期。
- 错误恢复后，需要前进回到下一页继续流程。
如果要进入一个明确的新地址，优先使用 导航到 URL；如果只是切换已有标签页，使用窗口切换类指令。
- 当前页面前面曾经执行过后退，浏览器有可前进的历史记录。
- 前进可能触发页面重新加载，页面状态可能发生变化。
- 前进后要用哪个 URL、标题或关键元素判断已经回到目标页。
- 如果前进后要继续操作元素，建议接等待页面或等待元素。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”- 先让浏览器产生历史记录，并执行一次 网页后退。
- 在需要返回下一页的位置添加 网页前进 指令。
- 普通页面无需额外配置；如需指定成功状态，可在「网页前进选项」中设置
waitUntil（如LOAD）。 - 页面较慢时，可在「网页前进选项」中调大
timeout，例如60000（毫秒）。 - 前进后添加 等待页面加载 或 等待元素存在。
一个前进/后退验证流程可以这样配置：
- 打开网页：进入列表页。
- 点击元素：进入详情页。
- 网页后退：返回列表页。
- 网页前进：重新进入详情页。
- 等待元素存在：等待详情页关键区域出现。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| 网页前进选项 | goForwardOptions | JSON | 否 | - | 网页前进的高级配置选项（JSON）。可包含超时时间 timeout（单位毫秒）与成功状态 waitUntil（支持 LOAD、DOMCONTENTLOADED、NETWORKIDLE、COMMIT）等设置，大多数场景无需配置。 |
该指令没有业务输出变量，主要作用是改变当前页面地址。是否成功应通过页面地址、运行日志和后续等待节点判断。
- 当前页面前进到浏览器历史记录中的下一页，或地址/内容符合预期。
- 运行日志中没有超时、网络或权限错误。
- 后续等待元素、点击、输入或读取节点能继续执行。
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 前进后页面没变化 | 当前页没有可前进历史记录 | 确认前面已经执行过后退，且历史记录未被清空 |
| 前进超时 | 下一页加载慢或网络异常 | 调大超时时间，或改用更合适的成功状态 |
| 前进后找不到元素 | 页面还在异步渲染 | 前进后增加等待页面加载或等待元素存在 |
| 前进后页面不是预期页面 | 历史记录顺序和预期不同 | 用获取 URL 或标题确认当前页面，再决定是否前进 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
bots.openUrl(url="https://example.com/list")bots.navigateToUrl(rawUrl="https://example.com/detail/1001")bots.backPage()
# 回到刚才的详情页（如需自定义超时/成功状态，可传入 goForwardOptions）bots.forwardPage()bots.forwardPage(goForwardOptions={"timeout": 60000, "waitUntil": "LOAD"})如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：当前页面没有前进历史记录会怎样？
Section titled “Q1：当前页面没有前进历史记录会怎样？”A： 前进可能不会产生可见变化。建议在前进后用 URL、标题或关键元素确认是否进入目标页。
Q2：前进会影响页面状态吗？
Section titled “Q2：前进会影响页面状态吗？”A： 可能会。前进可能重新加载页面、重新执行初始化脚本，也可能恢复浏览器缓存中的页面状态。