关闭指定索引网页

关闭指定索引网页 用于根据页面索引关闭浏览器中的指定标签页。索引从 0 开始计算，常用于多标签页流程中的窗口管理、资源释放和环境清理。

指令标识：ClosePageIndex
指令类型：网页指令
指令描述：根据页面索引关闭浏览器中的指定页面，索引从 0 开始计算

先选使用方式

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

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

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

什么时候用？

在新标签页完成操作后，根据索引关闭该窗口，返回主窗口继续操作。
多窗口操作完成后，按索引批量关闭不再需要的窗口。
在自动化测试中，按索引清理测试产生的临时窗口。
在多页面流程中，按索引控制窗口的打开和关闭顺序。

使用前确认

浏览器中已经存在多个标签页，且你知道目标页面的索引。
索引从 0 开始，按 Chrome 浏览器中网页的打开顺序计算。
关闭页面后剩余页面索引会重新排序，建议从后往前关闭。
本指令属于页面操作类，默认失败处理为「报错中止」（STOP_ON_FAILURE），索引超范围会抛出异常。

可视化编排：从 0 到跑通

确认浏览器中已经打开了多个标签页。
在工作流画布中添加 关闭指定索引网页 节点。
在索引中填写要关闭的页面索引，例如 0 表示第一个打开的窗口。
如需调整等待时长，在高级参数 超时时间 中配置（默认 2000 毫秒）。
运行后确认目标窗口已被关闭。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
索引	`index`	Integer	是	-	要关闭页面的索引，从 `0` 开始的数字，按浏览器中网页打开顺序计算。
超时时间	`timeout`	Double	否	`2000`	高级参数。等待页面关闭的最大时长，超出则抛出异常，单位毫秒；设为 `0` 表示不等待。

输出参数

该指令无输出参数。是否成功建议通过页面状态、运行日志或后续节点判断。

成功标准

目标索引对应的标签页已被关闭。
剩余标签页按新的索引顺序排列。
运行日志中没有索引超范围或超时错误。

失败排查

现象 / 报错原文	可能原因	处理建议
日志报 `index超出范围`	指定索引超过当前页面数量	先确认当前标签页数量，索引取值范围为 `0` 到（页面数 - 1）
关闭了错误的窗口	之前已关闭页面导致索引重排	建议从后往前关闭，或在关闭前重新获取目标索引
等待页面关闭超时	页面响应慢	适当调大「超时时间」，或设为 `0` 不等待

Python 代码编排

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

# 先打开示例网站
bots.openUrl(url="https://example.com")

# 关闭索引为 0 的标签页
bots.closePageIndex(index=0)

如需调整等待页面关闭的时长，可传入 timeout：

bots.closePageIndex(index=0, timeout=2000)

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

常见问题

Q1：索引是从几开始计算的？

A：索引从 0 开始计算，第一个打开的窗口索引为 0，第二个为 1，以此类推。

Q2：关闭窗口后索引会变化吗？

A：会。关闭页面后，剩余页面的索引会重新排序。建议从后往前关闭窗口，避免索引变化带来的问题。

Q3：如果索引超出范围会怎样？

A：如果指定的索引超出当前页面数量范围，系统会抛出异常并提示 index超出范围。

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

A：如果关闭的是当前活动窗口，系统会自动切换到其他可用窗口继续执行后续操作。