跳转到内容
MagicAI 工作流 MagicAI 工作流

新建标签页

新建标签页 用于在当前浏览器实例中再开一个标签页。新标签页可以保持空白，也可以直接打开一个网址，常用于需要同时操作多个页面的场景。

指令标识：NewTab
指令类型：网页指令
指令描述：在当前浏览器实例中新建一个标签页，可空白或打开指定网址

先选使用方式

Section titled “先选使用方式”

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

方式怎么用适合人群
可视化编排（推荐先学）拖入「新建标签页」节点，按需填写要打开的网址大多数用户，零代码，适合快速搭建和调试
代码编排（Python）在脚本中调用 bots.newTab(url="https://example.com")熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

Section titled “什么时候用？”
  • 需要在不关闭当前页面的情况下，再打开一个页面继续操作。
  • 一个流程里要同时维护多个页面，例如一边查询、一边录入。
  • 点击会在当前标签页跳转，但你希望新开一个标签页处理。

如果只是要在已有页面跳转到另一个地址，请使用 导航到 URL；如果是流程第一步要启动浏览器，请使用 打开网页。

使用前确认

Section titled “使用前确认”
  • 浏览器执行环境已经初始化（通常前面已有「打开网页」节点）。
  • 如果要直接打开网址，建议填写包含 http:// 或 https:// 的完整地址。省略协议时引擎会自动补 http://。
  • 新建标签页后，当前活动页会切换到这个新标签页，后续操作默认作用在它上面。
新建标签页

可视化编排：从 0 到跑通

Section titled “可视化编排：从 0 到跑通”

下面用一个常见场景演示：在已打开的后台页面上，再新开一个标签页打开帮助文档。

  1. 确认前面已有 打开网页 节点，浏览器已经启动。
  2. 在画布中添加 新建标签页 节点。
  3. 在右侧 网址 中填写要打开的地址（留空则新建空白标签页）：
https://help.example.com
  1. 点击运行，确认新标签页已打开，且当前活动页已切换到新标签页。
  2. 在后续节点中添加 等待页面加载，再继续操作新标签页内容。

参数说明

Section titled “参数说明”

输入参数

Section titled “输入参数”
界面名称代码属性名类型必填默认值说明
网址urlString否-新标签页要打开的网址。留空则新建空白标签页。建议填写完整协议。
浏览器类型browserTypeEnum否CHROME启动浏览器的类型，可选 CHROME（Chrome）、FIREFOX（Firefox）、WEBKIT（Safari），默认 CHROME。

输出参数

Section titled “输出参数”

该指令没有输出变量。新建成功后，当前活动页会自动切换到新标签页，后续指令默认作用在它上面。

成功标准

Section titled “成功标准”
  • 新建标签页 节点运行结束后状态为成功。
  • 运行日志中没有参数缺失、超时或执行失败等错误。
  • 后续节点能够继续执行，流程没有因为该节点异常中断。

失败排查

Section titled “失败排查”
现象 / 报错原文可能原因处理建议
日志报 No browser context浏览器执行环境未初始化在本节点前先添加「打开网页」节点启动浏览器，再重试
新标签页打开了但没有加载网址网址为空或地址不合法检查「网址」是否填写正确，建议带上 https://
新标签页打开慢、后续节点找不到元素页面还没加载完成在新建标签页后增加「等待页面加载」或「等待元素存在」节点

Python 代码编排

Section titled “Python 代码编排”

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

# 新建一个空白标签页
bots.newTab()


# 新建标签页并直接打开网址
bots.newTab(url="https://help.example.com")

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

常见问题

Section titled “常见问题”

Q1：新建标签页后，后续指令作用在哪个页面？

Section titled “Q1：新建标签页后，后续指令作用在哪个页面？”

A： 作用在新建的这个标签页上。新建成功后当前活动页会自动切换到新标签页，如果你想切回原来的页面，可使用切换窗口相关指令。

Q2：网址留空会怎样？

Section titled “Q2：网址留空会怎样？”

A： 会新建一个空白标签页（about:blank）。你可以在后续节点用 导航到 URL 再加载具体地址。

相关指令

Section titled “相关指令”