关闭指定标题网页

关闭指定标题网页 用于在浏览器 RPA 中根据页面标题关闭匹配的窗口。当流程中打开了多个页面、需要按标题精确关掉某个窗口时使用，常见于弹窗清理、窗口管理和资源释放。

指令标识：ClosePageByTitle
指令类型：网页指令
指令描述：根据页面标题关闭浏览器中的指定窗口，标题需要完全匹配

先选使用方式

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

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

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

什么时候用？

流程中打开了多个窗口，需要按标题关掉其中某个。
自动关闭弹出的广告或临时窗口，保持环境整洁。
多窗口操作完成后，释放不再需要的窗口资源。

如果你更习惯按地址或索引关闭窗口，可使用关闭指定URL网页或关闭指定索引网页。

使用前确认

已知目标窗口的完整标题，标题为完全匹配（区分大小写、包含空格与标点）。
目标窗口当前已打开，可先用获取当前网页标题确认标题文本。
该指令默认失败即中止（报错中止）：超出等待时长仍未关闭会抛出异常。
如不确定标题，可先切换到指定标题网页核对。

可视化编排：从 0 到跑通

下面用一个常见场景演示：打开一个示例页面，再按标题把它关掉。按 4 步即可跑起来：

在前序流程中通过打开网页打开目标页面。
添加 关闭指定标题网页 节点，在标题中填写要关闭的窗口标题：

示例网站 - 首页

如页面关闭较慢，可在高级区适当调大 超时时间。
点击运行，确认该标题对应的窗口已被关闭。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
标题	`title`	String	是	-	需要关闭的页面标题，完全匹配，不能为空
超时时间	`timeout`	Double	否	`2000`	高级选项。等待页面关闭的最大时长（毫秒），超出则抛出异常；设为 `0` 表示不等待

输出参数

无。

成功标准

指定标题对应的窗口已被关闭。
浏览器自动切换到其他可用窗口，后续节点可继续执行。
运行日志中没有「窗口不存在」或超时错误。

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

标题为 示例网站 - 首页 的窗口消失，窗口列表中不再包含它。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 `指定标题的窗口不存在`	标题填写有误或窗口尚未打开	用「获取当前网页标题」核对完整标题，确认窗口已打开
标题对了仍关不掉	标题不是完全匹配（大小写、空格、标点不一致）	严格按实际标题逐字填写
等待超时	页面关闭较慢或被脚本阻塞	适当调大「超时时间」，或排查页面是否有未关闭的弹窗
关闭了非预期窗口	存在多个相同标题的窗口	系统关闭第一个匹配窗口；建议保证标题唯一或改用按 URL/索引关闭

Python 代码编排

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

# 先打开示例页面
bots.openUrl(url="https://example.com/")
# 按标题关闭该窗口
bots.closePageByTitle(title="示例网站 - 首页")

如页面关闭较慢，可调大超时时间：

bots.closePageByTitle(
    title="示例网站 - 首页",
    timeout=2000,
)

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

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

常见问题

Q1：标题匹配规则是什么？

A：标题必须完全匹配，区分大小写，包括空格、标点等所有字符，系统不做模糊匹配。

Q2：存在多个相同标题的窗口会怎样？

A：系统会关闭第一个匹配的窗口。建议保证标题唯一，或改用按 URL、索引关闭。

Q3：找不到匹配标题会怎样？

A：会抛出异常并提示 指定标题的窗口不存在，流程中止。

Q4：关闭当前活动窗口后会发生什么？

A：系统会自动切换到其他可用窗口，继续执行后续操作。