# JSTestDriver

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 所需插件：
>
>
>
> `JavaScript 和 TypeScript`  -  插件与 IntelliJ IDEA 捆绑在一起，并默认启用。
>
>
>
> `JSTestDriver`  -  在   设置 | 插件   页面上安装插件。 该插件仅在拥有 Ultimate 订阅的 IntelliJ IDEA 中可用。

IntelliJ IDEA 支持与 [JSTestDriver test framework](https://code.google.com/archive/p/js-test-driver/wikis/GettingStarted.wiki) 的集成。

## 开始之前

Procedure:

1. 请确保已在设置中启用  JavaScript 和 TypeScript  插件。 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))打开设置，然后选择  `插件` 。 在搜索字段中，键入  JavaScript 和 TypeScript 。 有关插件的更多信息，请参阅 [管理插件](managing-plugins.html)。

2. 按照 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo) 中所述，在   设置 | 插件   页面上安装并启用  JSTestDriver  插件。 该插件仅在拥有 Ultimate 订阅的 IntelliJ IDEA 中可用。

通过此插件，IntelliJ IDEA 提供了 JSTestDriver 服务器和断言框架。 在创建测试时，插件会检测单元测试框架并建议  添加 <测试框架> 支持  [意图操作](intention-actions.html)。

## 在项目中配置测试框架

Procedure:

1. 下载您选择的框架，并 [将其配置为 一个 IntelliJ IDEA JavaScript library](configuring-javascript-libraries.html#ws_js_custom_third_party_library)。

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

* [将项目文件夹添加到库范围](configuring-javascript-libraries.html#ws_js_configuring_js_libs_change_scope)。

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

* 要使用 Jasmine，请将 `jasmine-jstd-adapter` 添加到配置文件中。 打开 `jsTestDriver.conf` 并在其中输入以下代码： ``` load: lib/jasmine/jasmine.js lib/jasmine-jstd-adapter/JasmineAdapter.js ```

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

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

Procedure: 创建配置文件

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

2. 在打开的   新建文件  对话框中，输入带有  `.jstd` 或  `.conf` 扩展名的配置文件名称。

3. 在编辑器中打开新文件，并指定当前文件夹的完整路径及相对于它的文件路径。 在文件名模式中使用通配符。

4. 使用 [YAML](http://www.yaml.org/) 完成配置文件，请参考 [测试运行器配置文件说明](http://code.google.com/p/js-test-driver/wiki/ConfigurationFile)。

## 运行测试

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

Procedure: 要从编辑器运行单个测试

* 点击 ![运行按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg)或 ![重新运行按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.rerun.svg)左侧栏中，并从列表中选择   运行 <test_name>  。

* 您还可以在编辑器中查看测试是否通过或失败，由于装订区域的  测试状态 图标 ![测试通过](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.green2.svg) 和 ![测试失败](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.red2.svg)。

> **Tip:**
> 只有当您的测试中使用的测试框架与项目相关联时，箭头才会出现，所以 IntelliJ IDEA 可以识别这些测试。

Procedure: 创建 JSTestDriver 运行配置

1. 打开 [运行/调试配置](run-debug-configurations-dialog.html)对话框（  `运行 | 编辑配置` 在主菜单中），点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)在左侧窗格中，然后从列表中选择   JSTestDriver  。   运行/调试配置：JSTestDriver  对话框打开。

> **Tip:**
> 或者，在   项目   工具窗口 ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) 中选择一个测试文件，然后从上下文菜单中选择   创建 <文件名>  。

2. 指定要运行的测试、配置文件的路径以及在测试执行之前要执行的活动。

Procedure: 启动 WebStorm 默认 JSTestDriver 测试服务器

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

2. 打开   JSTestDriver 服务器   工具窗口（  `视图 | 工具 Windows | JSTestDriver 服务器` ），然后点击工具栏上的 ![运行按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)。

> **Tip:**
> 如需使用在另一台机器上运行或监听自定义端口的测试服务器，请按照服务器特定的说明启动它，并在   服务器   区域的   运行/调试配置：JSTestDriver   对话框中指定其 URL 地址。

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

* 点击 ![停止本地服务器按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.suspend.svg) 工具栏。

Procedure: 捕获浏览器

1. 如果尚未运行，请 [启动 JSTestDriver 服务器](#start_server)，然后切换到   JSTestDriver 服务器  工具窗口。

2. 要启动带有   远程控制台  的   JSTestDriver  的本地浏览器，请执行以下操作之一：

* 点击指示您选择的浏览器的图标。

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

在任一情况下，指示所选浏览器的图标将变为激活状态。

3. 切换到   JSTestDriver 服务器   工具窗口并点击表示您刚刚打开的浏览器的图标。 IntelliJ IDEA 显示一条消息，通知您它已准备好执行测试。

Procedure: 通过运行配置运行测试

1. 从配置列表中选择 JSTestDriver 运行/调试配置，然后在列表或工具栏中点击 ![运行图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)。

2. 在   测试运行器   选项卡的   运行   工具窗口中监控测试执行并分析测试结果。 有关详细信息，请参考 [探索测试结果](viewing-and-exploring-test-results.html)。

## 导航

使用 IntelliJ IDEA，您可以在文件与相关的测试文件之间跳转，或从 [测试运行器选项卡](null) 中的测试结果跳转到测试。

Procedure:

* 在编辑器中打开文件，选择上下文菜单中的  `转到 | 测试`  或  `转到 | 测试对象` ，或者直接按 `Ctrl+Shift+T` (Windows), `⌘ ⇧ T` (macOS), `⌘ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ T` (macOS System Shortcuts), `Ctrl+Shift+T` (XWin), `Ctrl+Shift+T` (GNOME), `Ctrl+Shift+T` (KDE), `Ctrl+Shift+T` (Emacs), `Ctrl+Shift+T` (Sublime Text), `Ctrl+Shift+T` (Sublime Text (macOS)), `Ctrl+Shift+T` (Visual Studio), `Ctrl+Shift+T` (Visual Studio (macOS)), `Ctrl+Shift+T` (NetBeans), `Ctrl+Shift+T` (Eclipse), `Ctrl+Shift+T` (Eclipse (macOS))，即可在测试和其主题之间进行切换。

* 从测试结果跳转到测试定义，双击   测试运行器   选项卡中的测试名称，或从上下文菜单中选择  `跳转到源` ，或者按 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))。 测试文件在编辑器中打开时，文本光标放置在测试定义处。

## 调试测试

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

Procedure: 开始调试测试

1. 创建 JSTestDriver 运行/调试配置 [如上所述](#create_JSTestDriver_configuration)。

2. 从配置列表中选择 JSTestDriver 运行/调试配置，然后在列表或工具栏中点击 ![调试图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg)。

3. 在打开的 [调试工具窗口](debug-tool-window.html) 中，按常规方式进行操作： [单步执行程序](stepping-through-the-program.html)、 [停止并恢复](starting-the-debugger-session.html#pause-resume)程序执行、 [在暂停时检查](examining-suspended-program.html)、查看调用堆栈和变量、设置监视、评估变量、 [查看实际的 HTML DOM](viewing-actual-html-dom.html) 等。

要忽略源代码映射并逐步执行实际运行的代码，请在   调试  工具窗口的工具栏上点击 ![禁用源代码映射切换按钮​](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png)。

## 监控代码覆盖率

使用 IntelliJ IDEA，您还可以监控代码中有多少部分被 [Karma 测试覆盖](http://en.wikipedia.org/wiki/Code_coverage)。 IntelliJ IDEA 会在专用的   覆盖率   工具窗口中显示此统计信息，并在编辑器和   项目   工具窗口 ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))) 中以可视化方式标记已覆盖和未覆盖的行。

Procedure: 要启动具有覆盖率的测试

1. 创建 JSTestDriver 运行/调试配置 [如上所述](#create_JSTestDriver_configuration)。

2. [启动 JSTestDriver 服务器](#start_server)并 [捕获浏览器](#capture_browser)以运行测试。

3. 从配置列表中选择 JSTestDriver 运行/调试配置，然后在列表或工具栏中点击 ![运行覆盖率图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.runWithCoverage.svg)。

4. 在 [Coverage](null) 工具窗口中监控代码覆盖率。

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

1. 创建 JSTestDriver 运行/调试配置 [如上所述](#create_JSTestDriver_configuration)。

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

## See also

### 过程

[测试框架](testing-frameworks.html)