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