打开网页

打开网页 用于启动浏览器并访问目标 URL。它通常是浏览器 RPA 的第一步，后续再接等待、点击、输入、获取文本等网页元素操作。

指令标识：OpenUrl
指令类型：网页指令
指令描述：使用指定浏览器打开网页，以实现网页自动化

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「打开网页」节点，在右侧表单填写网址和超时时间	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.openUrl(url="https://example.com")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

流程第一步需要打开一个新网页。
需要从固定网站开始做数据采集、后台操作或表单填写。
希望每次运行都从同一个入口页面开始，减少环境差异。

如果浏览器已经打开，只是要在当前页面跳转到另一个地址，可以优先使用导航到 URL。

使用前确认

建议 URL 包含 http:// 或 https://。如果省略协议，运行时会自动补 http://，但显式填写协议更稳定。
当前执行环境能访问目标网站。
如果目标页面需要登录，请确认登录态或连接方式已经准备好。
如果后续要点击或读取页面内容，请提前规划一个稳定的等待元素。

可视化编排：从 0 到跑通

下面用一个常见场景演示：打开电商商家后台登录页，为后续自动登录、抓取订单做准备。按 4 步即可跑起来：

在工作流画布中添加 打开网页 指令，通常放在流程第一步。
在右侧配置面板的网址中填写目标页面，例如商家后台登录地址：

https://admin.example.com/login

点击运行，确认浏览器打开了登录页。
在后续节点中添加等待页面加载或等待元素存在（例如等待登录框出现），再继续输入账号密码、点击登录。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
网址	`url` / `value`	String	是	-	要打开的网页地址。建议填写完整协议，例如 `https://example.com`。
超时时间	`timeout`	Number	否	60000（约 60 秒）	打开网页的最大等待时间，单位毫秒。页面较慢时可适当调大。
页面默认超时	`newPageOptions.defaultTimeout`	Number	否	浏览器默认值	高级参数，用于设置新页面后续操作的默认等待时间。大多数用户无需配置。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	String	否	保存最终打开的 URL。一般不需要配置，只有后续流程要引用页面地址时才使用。

大多数场景不需要依赖该输出，是否成功仍建议通过页面状态、运行日志和后续等待节点判断。

成功标准

浏览器窗口或页面已经打开。
页面地址与配置的 URL 一致。
后续等待节点能找到页面关键元素。
运行日志中没有网络、权限或超时错误。

运行后你会看到（以上面场景为例）：

浏览器打开了登录页，地址栏与「网址」填写的 https://admin.example.com/login 一致。
运行日志出现类似下面的成功记录：

[OpenUrl] success url=https://admin.example.com/login elapsed=1840ms

如果配置了「将结果保存至」（如 currentUrl），后续节点即可引用该变量，值为最终打开的地址 https://admin.example.com/login。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 `OpenUrl requires "url" attribute`	网址参数为空	检查「网址」是否填写；代码编排确认 `url` 参数已传入
日志报 `OpenUrl timeout: <网址>`	页面加载慢、目标站点无响应	适当调大超时时间；引擎会自动降级重试，仍失败再排查网络与站点可用性
日志报 `No browser context`	浏览器执行环境未正确初始化	检查执行环境的浏览器配置，重试或重启执行环境
页面能打开但不是预期内容	登录态失效、被重定向、环境不一致	检查账号登录态，确认执行环境与手动操作环境一致
后续节点找不到元素	页面还没加载完成	在打开网页后增加「等待页面加载」或「等待元素存在」节点

Python 代码编排

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

# 打开商家后台登录页
bots.openUrl(url="https://admin.example.com/login")

如果页面加载较慢，可以增加超时时间：

bots.openUrl(
    url="https://admin.example.com/login",
    timeout=30000,
)

如果后续流程需要引用实际打开后的地址，可以保存到变量：

bots.openUrl(
    url="https://admin.example.com/login",
    outKey="currentUrl",
)

可视化表单里的「网址」「超时时间」「将结果保存至」分别对应代码里的 url、timeout、outKey。

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

常见问题

Q1：URL 必须包含协议吗？

A：建议包含协议（http:// 或 https://）。如果省略协议，运行时会自动补 http://，但显式填写协议更稳定。

Q2：首次启动浏览器需要多长时间？

A：首次启动浏览器可能较慢（2-5 秒），这是正常现象，建议设置合适的超时时间。