GoLand 2026.2 Help

JSTestDriver

GoLand 支持与 JSTestDriver test framework 的集成。

在开始之前

  1. 请确保在设置中启用了 JavaScript 和 TypeScript 插件。 按下 Ctrl+Alt+S 打开设置，然后选择 插件。 点击 已安装 选项卡。 在搜索字段中，键入 JavaScript and TypeScript。 有关插件的更多信息，请参阅 插件管理。

  2. 按照 从 JetBrains Marketplace 安装插件 中的说明，在 设置 | 插件 页，选项卡 市场 上安装并启用 JSTestDriver 插件。

    通过此插件，GoLand 提供了 JSTestDriver 服务器和断言框架。 在创建测试时，插件会检测单元测试框架并建议 添加 <测试框架> 支持 意图操作。

在项目中配置测试框架

  1. 下载您选择的框架，并 将其配置为 一个 GoLand JavaScript library。

  2. 请执行以下操作之一：

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

    • 在创建测试时，使用 添加 <测试框架> 支持 意图操作动态启用框架支持。

    • 要使用 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 ，您可以在文件与相关测试文件之间跳转，或从 测试运行器选项卡中的测试结果跳转到测试。

  • 在编辑器中打开文件，选择上下文菜单中的 转到 | 测试 或 转到 | 测试对象 ，或者直接按 Ctrl+Shift+T ，即可在测试和其主题之间进行切换。

  • 从测试结果跳转到测试定义，双击 测试运行器 选项卡中的测试名称，或从上下文菜单中选择 跳转到源 ，或者按 F4。 测试文件在编辑器中打开时，文本光标放置在测试定义处。

调试测试

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

开始调试测试

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

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

  3. 在打开的 调试工具窗口 中，按常规操作： 逐步执行程序， 停止并恢复 程序执行， 在挂起时检查程序 ，探索调用堆栈和变量，设置监视，评估变量， 查看实际 HTML DOM 等。

    要忽略源代码映射并逐步执行实际运行的代码，请在 调试 工具窗口的工具栏上按 禁用源代码映射切换按钮。

监控代码覆盖率

使用 GoLand，您还可以监控代码有多少 通过 Karma 测试覆盖。 GoLand 会在专用的 覆盖率 工具窗口中显示此统计信息，并在编辑器和 项目 工具窗口（Alt+1 ）中以可视化方式标记已覆盖和未覆盖的行。

要启动具有覆盖率的测试

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

  2. 启动 JSTestDriver 服务器并 捕获浏览器以运行测试。

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

  4. 在 Coverage 工具窗口中监控代码覆盖率。

要从覆盖率分析中排除文件

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

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

2026年 7月 14日
JestKarma