GoLand 2025.2 Help

JSTestDriver

GoLand 支持与 JSTestDriver 测试框架 集成。

准备工作

  • 按照 从 JetBrains Marketplace 安装插件 中所述,在 设置 | 插件 页签的 Marketplace 标签页中安装并启用 JSTestDriver 插件。

    通过该插件,GoLand 提供 JSTestDriver 服务器和断言框架。 在创建测试时,插件将检测单元测试框架并建议使用 Add <test framework> support intention action

在项目中配置测试框架

  1. 下载所选框架并 将其配置为 一个 GoLand JavaScript 库

  2. 请执行下列操作之一:

    • 将项目文件夹添加到库作用域

    • 在创建测试过程中通过 Add <test framework> support intention action 即时启用框架支持。

    • 要使用 Jasmine,请将 jasmine-jstd-adapter 添加到配置文件中。

      打开 jsTestDriver.conf 并在其中键入以下代码:

      load: lib/jasmine/jasmine.js lib/jasmine-jstd-adapter/JasmineAdapter.js

手动创建测试运行器配置文件

测试运行器配置文件定义要加载的测试和生产文件及其加载顺序。 GoLand 会将扩展名为 .jstd .conf 的任何文件视为测试运行器配置文件。

创建配置文件

  1. 项目 树中,选择生产和测试文件夹的父文件夹,并从上下文菜单中选择 新建 | 文件

  2. 在打开的 新建文件 对话框中,键入配置文件的名称,并使用扩展名 .jstd .conf

  3. 在编辑器中打开新文件,指定当前文件夹的完整路径以及待加载文件相对于该路径的相对路径。 在文件名模式中使用通配符。

  4. 使用 YAML 完善配置文件,参阅 测试运行器配置文件说明

运行测试

使用 GoLand,可以直接从编辑器快速运行单个 JSTestDriver 测试,也可以创建运行/调试配置来运行部分或全部测试。

从编辑器运行单个测试

  • 点击左侧标记中的 运行按钮重新运行按钮 ,然后从列表中选择 运行 <test_name>

  • 通过显示在编辑器侧边栏中的 测试状态 图标 测试通过测试失败 ,您还可以查看测试是否通过或失败。

创建 JSTestDriver 运行配置

  1. 打开 运行/调试配置 对话框(通过主菜单中的 运行 | 编辑配置 ),点击左侧窗格中的 添加按钮 ,并从列表中选择 JSTestDriver。 会打开 运行/调试配置:JSTestDriver 对话框。

  2. 指定要运行的测试、配置文件路径以及测试运行前要执行的操作。

启动 WebStorm 默认的 JSTestDriver 测试服务器

  1. 请确保项目中至少有一个配置文件。

  2. 打开 JSTestDriver 服务器 工具窗口(视图 | 工具窗口 | JSTestDriver 服务器 ),然后点击工具栏上的 运行按钮

完成单元测试后停止服务器

  • 点击工具栏上的 停止本地服务器按钮

捕获浏览器

  1. 启动 JSTestDriver 服务器 (如果尚未启动),然后切换到 JSTestDriver 服务器 工具窗口。

  2. 要使用 远程控制台JSTestDriver 启动本地浏览器,请执行以下任一操作:

    • 单击表示您所选浏览器的图标。

    • 如果浏览器已打开,请复制 使用 URL 捕获浏览器 只读字段中的内容,并将该 URL 粘贴到地址栏中。

    无论哪种方式,用于表示所选浏览器的图标都会激活。

  3. 切换到 JSTestDriver 服务器 工具窗口,然后单击表示您刚刚打开的浏览器的图标。 GoLand 会显示一条消息,告知您可以开始执行测试。

通过运行配置运行测试

  1. 从配置列表中选择 JSTestDriver 运行/调试配置,然后在列表中或工具栏上点击 运行图标

  2. 测试运行器 选项卡的 运行 工具窗口中监视测试执行并分析测试结果。 有关更多信息,请参阅 查看测试结果

导航

使用 GoLand,您可以在文件与其相关测试文件之间跳转,或从 测试运行器选项卡 中的测试结果跳转到测试。

  • 要在测试与其对应对象之间跳转,请在编辑器中打开该文件,然后从上下文菜单中选择 转到 | 测试(S)转到 | 测试目标 ,或直接按 Ctrl+Shift+T

  • 要从测试结果跳转到测试定义,请在 测试运行器 选项卡中双击测试名称,或从上下文菜单中选择 跳转到源 ,或直接按 F4。 测试文件将在编辑器中打开,光标定位在测试定义处。

调试测试

JSTestDriver 测试的调试会话只能通过运行/调试配置启动。

开始调试测试

  1. 如上所述创建 JSTestDriver 的运行/调试配置。

  2. 从配置列表中选择 JSTestDriver 运行/调试配置,然后在列表中或工具栏上点击 调试图标

  3. 在打开的 调试工具窗口 中,按常规方式继续操作: 逐步执行程序暂停并恢复程序执行、 在程序挂起时检查执行情况 、浏览调用堆栈和变量、设置监视、计算变量值、 查看实际 HTML DOM等。

监视代码覆盖率

使用 GoLand,您还可以监视代码有多少被 Karma 测试覆盖。 GoLand 会在专用的 覆盖率 工具窗口中显示该统计数据,并在编辑器和 项目 工具窗口中以可视化方式标记已覆盖和未覆盖的代码行 Alt+1

启动带覆盖率分析的测试

  1. 如上所述创建 JSTestDriver 的运行/调试配置。

  2. 启动 JSTestDriver 服务器 ,并 捕获一个浏览器用于运行测试。

  3. 从配置列表中选择 JSTestDriver 运行/调试配置,然后在列表中或工具栏上点击 运行并分析覆盖率图标

  4. 覆盖率 工具窗口中监视代码覆盖率。

将文件排除在覆盖率分析之外

  1. 如上所述创建 JSTestDriver 的运行/调试配置。

  2. 覆盖率 选项卡中指定要排除的文件路径。

最后修改日期: 2025年 9月 26日