获取当前网页索引

获取当前网页索引 用于获取当前活动窗口在浏览器已打开窗口中的索引位置，索引从 0 开始。它常用于多窗口流程中记录当前位置，方便后续切换、关闭或回到指定窗口。

指令标识：GetWindowIndex
指令类型：网页指令
指令描述：获取当前活动窗口在所有打开窗口中的索引位置，索引从0开始计数

先选使用方式

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

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

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

什么时候用？

打开新标签页或新窗口后，需要记录当前窗口索引。
多窗口流程中，需要保存主窗口索引，后续再切回来。
需要验证窗口切换是否发生在预期页面上。
后续要配合「切换到指定索引网页」或「关闭指定索引网页」使用。

使用前确认

浏览器环境已经启动，并至少存在一个可操作页面。
当前活动窗口就是你想记录的窗口。
了解索引从 0 开始计数，窗口关闭或新增后索引可能变化。
如果后续会用索引切换窗口，建议在关键步骤后及时重新获取索引，避免使用过期值。

可视化编排：从 0 到跑通

下面用一个常见场景演示：打开后台页面后，记录当前窗口索引，后续从新窗口切回原页面。按 4 步即可跑起来：

先添加打开网页打开目标页面。
添加 获取当前网页索引 节点。
在 将结果保存至 中填写变量名：

windowIndex

点击运行，确认变量保存了当前窗口索引，例如 0。

参数说明

输入参数

该指令无需配置输入参数。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	Integer	否	保存获取到的当前窗口索引（从 0 开始的整数），例如 `windowIndex`

成功标准

节点运行成功，日志中没有异常。
输出变量得到整数值，例如 0、1、2。
后续窗口切换、关闭等节点可以引用该索引变量。

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

输出变量 windowIndex 的值为当前活动窗口索引。
如果当前只有一个窗口，通常返回 0。

失败排查

现象 / 报错原文	可能原因	处理建议
输出总是 `0`	当前只有一个活动窗口，或没有可用窗口信息时默认返回 `0`	确认是否确实打开了多个窗口；必要时在打开新窗口后再获取索引
后续切换到错误窗口	获取索引后又打开或关闭了窗口，索引顺序发生变化	在窗口数量变化后重新执行本指令
输出变量为空	未配置「将结果保存至」或变量名写错	填写稳定的变量名，例如 `windowIndex`
后续节点无法使用变量	变量作用域或名称不一致	检查后续节点引用的变量名是否与 `outKey` 一致

Python 代码编排

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

# 打开后台页面后，记录当前活动窗口索引
bots.openUrl(url="https://example.com/admin")

bots.getWindowIndex(outKey="windowIndex")

可视化表单里的「将结果保存至」对应代码里的 outKey。

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

常见问题

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

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

Q2：如果当前没有活动窗口会返回什么？

A：如果当前没有活动窗口信息，系统将默认返回索引 0。

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

A：是的。窗口索引会随着窗口的打开和关闭而动态变化，获取的索引反映当前时刻的窗口状态。

Q4：该指令返回的是什么？

A：该指令获取的是当前活动窗口的索引，不是窗口总数。返回值为整数类型，可以用于窗口切换、条件判断等操作。