切换到指定索引网页

切换到指定索引网页 用于按标签页索引切换当前活动页面。索引从 0 开始，适合你明确知道目标页在当前浏览器上下文中的顺序时使用。

指令标识：SwitchToWindowIndex
指令类型：网页指令
指令描述：根据窗口索引切换到指定的浏览器窗口，索引从0开始计数

先选使用方式

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

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

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

什么时候用？

• 多个标签页按固定顺序打开，需要切回第一个或第二个页面。
• 完成辅助窗口操作后，切回主窗口继续流程。
• 测试或调试多窗口流程时，需要按顺序定位页面。
• URL 和标题都不够稳定，但标签页顺序可控。

如果页面顺序可能变化，优先使用 切换到指定URL网页 或 切换到指定标题网页。

使用前确认

• 当前浏览器上下文中已经打开目标标签页。
• 目标索引从 0 开始计算，第一个安全页签为 0。
• 关闭或新增标签页后，索引可能变化。
• 切换后后续网页指令会在新切换到的页面上执行。

可视化编排：从 0 到跑通

1. 先打开一个或多个网页标签页。
2. 添加 切换到指定索引网页 指令。
3. 在 索引 中填写目标标签页序号，例如 0 表示第一个标签页。
4. 切换后添加 等待元素存在，确认目标页可操作。

最小示例

一个切回主窗口的流程可以这样配置：

1. 打开网页：进入主页面（索引通常为 0）。
2. 点击元素：打开详情页或辅助页。
3. 切换到指定索引网页：填写 0，切回主页面。
4. 等待元素存在：等待主页面关键区域出现。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
索引	index	Integer	是	-	要切换到的标签页索引，从 0 开始计算（0 表示第一个标签页）。

输出参数

该指令没有业务输出变量，主要作用是切换当前活动页面上下文。

索引规则

源码会读取当前浏览器上下文中的安全页签列表，再按数组索引切换：

• 0 表示第一个可操作标签页。
• 索引小于 0 或大于等于页签数量时，会报 Window index <index> out of range (<count> pages)。
• Electron 内置浏览器场景下，主窗口页面会被过滤，不会被算作用户可操作标签页。

成功标准

• 当前活动页面切换到指定索引对应的标签页。
• 后续等待、点击、输入、读取节点都在目标页面执行。
• 运行日志中没有 “out of range” 或上下文错误。

失败排查

现象 / 报错原文	可能原因	处理建议
Window index <index> out of range (<count> pages)	索引超出当前页签数量	先确认当前打开了几个标签页，或改用标题/URL 切换
切换到了错误页面	标签页打开或关闭顺序和预期不同	使用获取 URL/标题确认页面，必要时改用 URL/标题切换
切换后后续节点找不到元素	页面切换成功但内容还没加载好	切换后增加等待元素存在
No browser context	当前没有浏览器上下文	先使用打开网页建立浏览器上下文

Python 代码编排

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

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

# 切换到第一个可操作标签页
bots.switchToWindowIndex(index=0)

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

常见问题

Q1：索引从几开始？

A： 从 0 开始。第一个可操作标签页是 0，第二个是 1。

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

A： 会。标签页新增或关闭后，索引可能变化。索引不稳定时，建议改用 URL 或标题切换。

Q3：切换后后续操作在哪个窗口执行？

A： 在新切换到的当前页面执行，直到再次切换、关闭页面或打开新页面。

相关指令

• 浏览器自动化指令入门
• 切换到指定标题网页
• 切换到指定URL网页
• 获取当前网页索引
• 关闭指定索引网页
• 打开网页