获取当前网页URL

获取当前网页URL 用于读取当前活动页面的完整地址，并保存到变量。它常用于确认页面是否跳转成功、记录采集来源、判断当前流程处于哪个页面。

指令标识：GetUrl
指令类型：网页指令
指令描述：获取当前活动窗口页面的完整URL地址，无需额外参数配置

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「获取当前网页URL」节点，填写输出变量	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `url = bots.getUrl(outKey="currentUrl")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

点击或跳转后，验证当前页面是否到了预期地址。
保存采集数据对应的来源 URL。
在多窗口场景中记录当前窗口地址。
根据当前 URL 做条件判断或流程分支。

如果要读取页面标题，请使用获取当前网页标题；如果要切换到某个 URL 对应的窗口，请使用切换到指定URL网页。

使用前确认

当前已经有可用的浏览器页面。
页面跳转已经完成，必要时先等待页面加载或等待关键元素。
已规划好保存 URL 的变量名，例如 currentUrl。

可视化编排：从 0 到跑通

在打开网页、导航到 URL 或点击跳转后添加 获取当前网页URL。
在 将结果保存至 中填写变量名，例如 currentUrl。
运行后查看变量值是否和浏览器地址栏一致。
后续可以用该变量做判断、输出或记录。

最小示例

一个验证跳转结果的流程可以这样配置：

打开网页：进入系统入口页。
点击元素：点击详情按钮。
等待元素存在：等待详情页关键区域出现。
获取当前网页URL：保存为 currentUrl。
结束节点：输出 currentUrl 或用于后续判断。

参数说明

输入参数

该指令没有业务输入参数，会直接读取当前活动页面的 URL。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	String	建议填写	保存当前页面的完整 URL。未配置时不会写入变量。

成功标准

输出变量中保存了当前页面完整 URL。
输出值与浏览器地址栏一致。
后续判断、记录或输出节点能正常引用该变量。

失败排查

现象	可能原因	处理建议
输出为空或没有变量	未填写 `outKey` 或变量名写错	在“将结果保存至”中填写变量名
URL 不是预期页面	页面跳转还没完成或被重定向	先等待页面加载或关键元素，再读取 URL
多窗口下读到错误 URL	当前活动页不是目标页	先切换到目标窗口，再读取 URL
指令失败	当前没有可用页面	先使用打开网页或切换到有效页面

Python 代码编排

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

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

# 保存当前页面 URL
url = bots.getUrl(outKey="currentUrl")
print(url)

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

常见问题

Q1：返回的 URL 包含哪些内容？

A：返回的是当前页面完整地址，通常包含协议、域名、路径、查询参数和锚点。

Q2：多窗口场景下获取的是哪个窗口的 URL？

A：获取的是当前活动页面的 URL。如需读取其他窗口，请先切换到目标窗口。

Q3：为什么读到的 URL 和预期不同？

A：常见原因是页面发生了重定向、跳转还没完成，或当前窗口不是目标窗口。建议先等待页面稳定再读取。