切换到指定标题网页

切换到指定标题网页 用于在多个浏览器标签页中，根据页面标题查找并切换到目标页面。它适合多窗口流程中页面 URL 不稳定、但标题相对可识别的场景。

指令标识：SwitchToWindowTitle
指令类型：网页指令
指令描述：根据窗口标题切换到匹配的浏览器窗口

先选使用方式

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

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

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

什么时候用？

点击后打开新标签页，需要按标题切换到新页面。
URL 会变化或包含动态参数，但页面标题稳定。
多窗口流程中，需要回到某个业务页继续操作。
当前活动页不是目标页，后续网页指令必须切换上下文。

如果 URL 更稳定，可以使用切换到指定URL网页；如果只知道标签页顺序，可以使用切换到指定索引网页。

使用前确认

目标页面已经打开在当前浏览器上下文中。
标题片段足够唯一，避免匹配到错误页面。
页面标题可能动态变化，建议先用获取当前网页标题确认实际标题。
切换后后续网页指令会在新切换到的页面上执行。

可视化编排：从 0 到跑通

先通过打开网页或点击动作打开目标页面。
添加 切换到指定标题网页 指令。
在标题中填写目标页面标题的稳定片段，例如：

订单详情

切换后添加等待元素存在，确认目标页可操作。

最小示例

一个切换到订单详情页的流程可以这样配置：

打开网页：进入订单列表页。
点击元素：点击订单详情链接，打开新标签页。
切换到指定标题网页：填写 订单详情。
等待元素存在：等待详情页订单号出现。
获取文本：读取订单状态。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
标题	`title`	String	是	-	用于匹配目标标签页标题。源码使用包含匹配，即目标页标题包含该值即可命中。

输出参数

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

匹配规则

源码会遍历当前浏览器上下文中的安全页签，并使用 page.title().includes(title) 判断是否命中。因此：

可以填写完整标题，也可以填写稳定标题片段。
片段越短，越容易误匹配到其他页面。
找不到匹配页时会报 No window found with title containing "<title>"。

成功标准

当前活动页面切换到标题包含目标值的标签页。
后续等待、点击、输入、读取节点都在目标页面执行。
运行日志中没有 “No window found” 或上下文错误。

失败排查

现象 / 报错原文	可能原因	处理建议
`SwitchToWindowTitle requires "title"`	标题参数为空	填写目标页面标题或稳定标题片段
`No window found with title containing "<title>"`	目标页面未打开，或标题片段不匹配	先确认目标页已打开；用获取当前网页标题确认实际标题
切换到了错误页面	标题片段太短，被其他页面包含	使用更长、更唯一的标题片段
切换后后续节点找不到元素	页面切换成功但内容还没加载好	切换后增加等待元素存在

Python 代码编排

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

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

# 切换到标题包含“订单详情”的页签
bots.switchToWindowTitle(title="订单详情")

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

常见问题

Q1：标题必须完全匹配吗？

A：不需要。源码使用包含匹配，目标页标题包含你填写的值就会命中。

Q2：如果多个页面都包含这个标题片段会怎样？

A：会切换到遍历到的第一个匹配页面。建议填写更唯一的标题片段，避免误切换。

Q3：标题会动态变化吗？

A：会。建议在页面稳定后再切换；不确定时，先用获取当前网页标题查看实际标题。