WebStorm 2025.2 Help

JSTestDriver

WebStorm 支持与 JSTestDriver 测试框架 的集成。

开始之前

  • 设置 | 插件 页的 Marketplace 选项卡上安装并启用 JSTestDriver 插件,参见 从 JetBrains Marketplace 安装插件

    通过该插件,WebStorm 提供 JSTestDriver 服务器和断言框架。 在创建测试过程中,插件可检测到单元测试框架,并建议使用 添加 <test framework> 支持 意图操作

在项目中配置测试框架

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

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

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

    • 在创建测试过程中使用 添加 <test framework> 支持 意图操作即可即时启用框架支持。

    • 若要使用 Jasmine,请在配置文件中添加 jasmine-jstd-adapter

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

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

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

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

创建配置文件

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

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

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

  4. 使用 YAML 完成配置文件,可参考 测试运行器配置文件说明

运行测试

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

从编辑器运行单个测试

  • 在左侧边距中点击 运行按钮重新运行按钮 ,然后从列表中选择 运行 <test_name>

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

创建 JSTestDriver 运行配置

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

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

启动 WebStorm 默认 JSTestDriver 测试服务器

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

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

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

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

捕获浏览器

  1. 若尚未运行,请先 启动 JSTestDriver 服务器 ,然后切换至 JSTestDriver 服务器 工具窗口。

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

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

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

    无论哪种情况,表示所选浏览器的图标都会变为活动状态。

  3. 切换到 JSTestDriver 服务器 工具窗口,并单击表示刚刚打开的浏览器的图标。 WebStorm 会显示一条消息,告知已准备好执行测试。

通过运行配置运行测试

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

    选择运行/调试配置
  2. 测试运行器 选项卡的 运行 工具窗口中监视测试执行情况并分析测试结果。 如需了解更多信息,请参阅 探索测试结果

导航

使用 WebStorm,您可以在文件与相关测试文件之间跳转,或从 Test Runner Tab 中的测试结果跳转到测试。

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

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

调试测试

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

开始调试测试

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

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

    选择运行/调试配置
  3. 在打开的 调试工具窗口 中,照常进行操作: 逐步执行程序停止和恢复 程序执行、 在程序挂起时进行检查 、浏览调用堆栈和变量、设置监视、计算变量值、 查看实际 HTML DOM 等。

监控代码覆盖率

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

使用覆盖率启动测试

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

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

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

    选择运行/调试配置
  4. Coverage 工具窗口中监视代码覆盖率。

从覆盖率分析中排除文件

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

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

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