刷新网页

刷新网页 用于重新加载当前浏览器页面，效果类似点击浏览器刷新按钮。它常用于页面状态异常、后台数据更新后重新加载，或在继续操作前让页面回到最新状态。

指令标识：ReloadPage
指令类型：网页指令
指令描述：重新加载当前浏览器页面，等同于点击浏览器的刷新按钮或按F5键

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。刷新网页 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「刷新网页」节点，按需在高级选项中设置刷新选项	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.reloadPage()`	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

页面数据已经更新，需要重新加载后读取最新内容。
页面出现空白、卡住或显示异常，需要尝试恢复。
点击提交、保存或筛选后，需要重新加载当前页面。
希望后续节点从刷新后的页面状态继续执行。

如果只是跳转到另一个地址，请使用导航到 URL；如果页面刷新后要操作元素，建议接等待页面加载或等待元素存在。

使用前确认

当前已经有可用的浏览器页面。
刷新不会丢失未保存的表单数据。
页面刷新后要用哪个关键元素判断业务内容已经恢复。
如果页面依赖登录态，请确认刷新后不会跳回登录页。

可视化编排：从 0 到跑通

确认前面已经通过打开网页或导航到 URL 进入目标页面。
在需要重新加载的位置添加 刷新网页 指令。
普通页面无需配置，直接保留默认即可。
页面较慢时，可在「刷新选项」(reloadOptions) 中调大超时时间或调整完成判断方式。
刷新后添加等待页面加载或等待元素存在。

最小示例

一个刷新后读取最新状态的流程可以这样配置：

打开网页：进入后台列表页。
点击元素：点击“同步数据”或“保存”按钮。
刷新网页：重新加载当前页面。
等待元素存在：等待列表区域出现。
获取文本：读取最新状态或数量。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
刷新选项	`reloadOptions`	JSON	否	-	刷新页面的高级配置（JSON），可包含 `timeout`（超时时间，单位毫秒）、`waitUntil`（完成判断方式：`LOAD`、`DOMCONTENTLOADED`、`NETWORKIDLE`、`COMMIT`）等。未配置时使用系统默认值，大多数场景无需设置（高级，可选）。
是否发送消息	`sendMsgFlag`	Boolean	否	True	是否发送通知消息。

输出参数

该指令没有业务输出变量，主要作用是重新加载当前页面。是否成功应通过运行日志、页面状态和后续等待节点判断。

成功标准

当前页面完成刷新，没有网络或超时错误。
页面没有停留在空白页、错误页或登录页。
后续等待元素、点击、输入或读取节点能继续执行。

失败排查

现象	可能原因	处理建议
刷新超时	页面资源加载慢、网络异常或站点无响应	调大超时时间，并手动确认页面可访问
刷新后跳到登录页	登录态失效或会话过期	重新登录，或检查执行环境里的登录态
刷新后后续节点找不到元素	页面内容仍在异步渲染	刷新后增加等待页面加载或等待元素存在
表单内容丢失	刷新前内容未保存	刷新前先保存，或避免在填写过程中刷新

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

bots.openUrl(url="https://example.com")

# 刷新当前页面
bots.reloadPage()

# 页面较慢时，可在刷新选项中调大超时时间（单位毫秒）
bots.reloadPage(reloadOptions={"timeout": 60000})

如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：执行刷新前需要什么条件？

A：当前必须已经有浏览器页面。源码会通过 requirePage() 获取当前页，如果没有页面，指令会失败。

Q2：刷新会影响表单数据吗？

A：会。刷新会重新加载页面，未保存的表单内容可能丢失，建议先保存再刷新。

Q3：刷新后还需要等待吗？

A：建议需要。刷新完成只代表浏览器加载状态达到要求，业务内容可能还在渲染，后面最好接等待页面或等待元素。