关闭指定URL网页

关闭指定URL网页 用于根据网页 URL 关闭浏览器中匹配的窗口（URL 需要完全匹配）。它常用于关闭临时页面、弹窗或处理完成的页面，实现窗口管理和资源释放。

指令标识：ClosePageByUrl
指令类型：网页指令
指令描述：根据窗口URL地址关闭匹配的浏览器窗口，URL需要完全匹配

先选使用方式

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

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

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

什么时候用？

关闭临时打开的页面或弹窗，如广告页、临时查询页等。
多页面操作完成后，根据 URL 关闭不再需要的页面，释放系统资源。
在自动化流程中根据 URL 精确控制页面的打开与关闭。
页面出现错误或异常时，根据 URL 关闭问题页面。
批量处理多个网站时，逐个关闭已处理完成的页面。

使用前确认

要关闭的 URL 已知，且与浏览器中页面的实际地址完全一致（包括协议、域名、路径和查询参数）。
页面已稳定，没有正在进行的重定向或 JavaScript 跳转。
如不确定页面实际 URL，可先使用获取当前网页URL 获取。

可视化编排：从 0 到跑通

下面用一个常见场景演示：打开一个临时页面后再将其关闭。按 4 步即可跑起来：

先用打开网页打开目标页面，例如 https://example.com/。
在工作流画布中添加 关闭指定URL网页 节点。
在 URL 中填写要关闭页面的完整地址：

https://example.com/

点击运行，确认该页面已被关闭。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
URL	`url`	String	是	-	需要关闭的页面 URL，不能为空，需与页面实际地址完全匹配。
超时时间	`timeout`	Double	否	`2000`	高级参数，等待页面关闭的最大时长，单位毫秒，超出则抛出异常；设置为 `0` 表示不等待。

输出参数

该指令无业务输出参数，执行结果通过运行日志和浏览器窗口状态确认。

成功标准

浏览器中与指定 URL 匹配的页面已被关闭。
运行日志中节点为成功状态，没有「窗口不存在」相关报错。
后续节点针对剩余页面的操作正常执行。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 `指定URL的窗口不存在`	URL 不完全匹配，或页面已被重定向	确认 URL 与页面实际地址完全一致；必要时先用「获取当前网页URL」获取真实地址
等待页面关闭超时	页面关闭较慢或被脚本阻塞	适当调大「超时时间」；确认页面无阻止关闭的弹窗
关闭了错误的页面	存在多个相同 URL 的窗口	系统会关闭第一个匹配的窗口，建议确保 URL 的唯一性

Python 代码编排

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

# 先打开一个临时页面
bots.openUrl(url="https://example.com/")

# 根据完整 URL 关闭该页面
bots.closePageByUrl(
    url="https://example.com/",
    timeout=2000,
)

可视化表单里的「URL」「超时时间」分别对应代码里的 url、timeout。

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

常见问题

Q1：URL 匹配规则是什么？

A： URL 必须完全匹配，包括协议（http/https）、域名、路径和查询参数等完整信息。系统进行完全匹配而非模糊匹配。

Q2：如果存在多个相同 URL 的窗口会怎样？

A：如果存在多个相同 URL 的窗口，系统将关闭第一个匹配的窗口。

Q3：如果找不到匹配的 URL 会怎样？

A：如果浏览器中没有与指定 URL 匹配的页面，系统会抛出异常提示 指定URL的窗口不存在。

Q4：URL 发生重定向怎么办？

A：页面 URL 可能因重定向或 JavaScript 操作而变化，建议在页面稳定后再执行该指令，或使用获取当前网页URL 获取实际 URL。