Jest

1. 请确保您的计算机上安装了 Node.js。

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

• 在嵌入的 终端 (Alt+F12 )中，输入：

  npm install --save-dev jest

从编辑器运行单个测试

• 点击装订区域中的 或 ，并从列表中选择 运行 <test_name>。

  

  您还可以在编辑器中直接查看测试是否通过或失败，这要归功于 测试状态 图标 和 。

从项目工具窗口运行文件夹中的所有测试

• 在 项目 工具窗口 Alt+1 中，选择包含测试的文件夹，然后选择 运行 'Tests in <folder name>'。

  

创建 Jest 运行配置

1. 打开 运行/调试配置对话框（运行 | 编辑配置 在主菜单中），点击 在左侧窗格中，然后从列表中选择 Jest。 “ 运行/调试配置：Jest” 对话框打开。

2. 指定要使用的 Node.js 解释器。

   如果您选择 项目 别名，PyCharm 将自动使用 Node 解释器 字段中 Node.js 页面的项目默认解释器。 在大多数情况下，PyCharm 会检测到项目的默认解释器并自动填写该字段。

   您也可以选择另一个已配置的本地或远程解释器，或点击 并配置一个新的。

3. 指定 jest、 react-scripts、 react-script-ts、 react-super-scripts 或 react-awesome-scripts 包的位置。

4. 指定应用程序的工作目录。 默认情况下， 工作目录 字段显示项目根文件夹。 若要更改此预定义设置，请指定所需文件夹的路径。

5. 指定要运行的测试。 这可以是一个特定的测试或套件，整个测试文件或包含测试文件的文件夹。

6. 可选地指定要使用的 jest.config.js 或 jest.config.ts 文件：从列表中选择相关文件，或点击 并在打开的对话框中选择它，或者直接在字段中键入路径。

   如果该字段为空，PyCharm 将寻找一个包含 jest 键的 package.json 文件。 搜索会从 working directory向上在文件系统中执行。 如果没有找到适当的 package.json 文件，则会即时生成一个 Jest 默认配置。

7. 可选：

   在相关源文件发生更改时自动配置重新运行测试。 要做到这一点，请在 --watch 标志中添加 Jest 选项 字段。

   您还可以稍后在测试会话期间，通过按 监视更改 切换按钮在 运行 工具窗口中开启 监视 模式，具体请参考下文 更改时自动重新运行测试（监视模式）。

8. 可选：

   指定执行命令的环境变量。 PyCharm 将在 process.env 的完成列表中显示这些变量。

   

9. 在 Node 选项 字段中，您可以选择性地输入特定于 Node.js 的命令行选项，以传递给 Node.js 可执行文件。 可接受的选项是：

   • 使用 --require coffeescript/register ，运行期间可以将 CoffeeScript 文件即时编译为 JavaScript。

     这种模式要求 register.js 文件（属于 coffeescript 软件包）位于您的项目内。 因此，请确保您已按照 安装 CoffeeScript 编译器中的说明，在本地安装了 coffeescript 包。

   • 使用 --inspect 或 --inspect-brk 参数以支持 Chrome Debugging Protocol。

   • 要在您的项目中使用 ECMAScript Modules ，请将 —experimental-vm-modules 标志添加到 Node 选项 字段。

通过运行配置运行测试

1. 从配置列表中选择 Jest 运行/调试配置，并点击 。

2. 在 测试运行器 选项卡的 运行 工具窗口中监控测试执行并分析测试结果。 如需更多信息，请参阅 探索测试结果。

重新运行失败的测试

• 点击 测试结果工具栏。 PyCharm 将执行上一会话中失败的所有测试。

• 若要重新运行某个特定失败的测试，请在其上下文菜单中选择 运行 <test name>。

有关更多信息，请参阅 重新运行测试。

更改时自动重新运行测试（观察模式）

PyCharm 支持 watch模式，在对测试相关的源文件进行任何更改后，测试会自动重新运行。 因此，您可以直接修改代码，而无需手动重新运行测试或重新启动 Jest run/debug configuration。

• 在 测试运行器选项卡中，按下 监视更改 切换按钮。

  

• 或者，在运行/调试配置的 Jest 选项 字段中添加 --watch 标志，请参阅上面的 创建一个 Jest 运行配置。

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

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

• 要从测试或套件定义跳转到 测试运行器 选项卡中的结果，请点击边栏中的 或 ，然后从列表中选择 在测试树中选择 <test_name>。

  

• 对于失败的测试，PyCharm 会从堆栈跟踪中将您带到测试中的失败行。 如果精确的行不在栈跟踪中， 您将被带到测试定义。

  

• 设置断点 所需的位置。

• 要从编辑器开始调试单个测试，请点击装订区域的 或 ，然后从列表中选择 调试 <test_name>。

• 要开始调试文件夹中的所有测试，请在 项目 工具窗口中选择该文件夹，然后从上下文菜单中选择 调试 'Tests in <folder name>'。

  

• 要通过运行/调试配置启动测试调试，请创建一个 Jest 运行/调试配置 如上所述。

  然后从配置列表中选择 Jest 运行/调试配置，并在列表或工具栏中点击 。

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

运行测试并生成覆盖率报告

1. 创建一个 Jest 运行/调试配置 ，如上所述。

2. 从主工具栏的列表中选择 Jest 运行/调试配置，并点击列表右侧的 &#xa0;。

   或者，您可以快速从编辑器中运行特定的套件或带覆盖率的测试：点击 或 并从列表中选择 运行 <test_name> 并生成覆盖率。

   

3. 在 Coverage 工具窗口中监控代码覆盖率。 报告显示了多少文件经过了测试及其中已覆盖代码行的百分比。 从报告中，您可以跳转到文件并查看哪些行已覆盖（标记为绿色）以及哪些行未覆盖（标记为红色）：

   

在开始之前

1. 按照 Node.js 和 Node.js Remote Interpreter 中的描述，在 设置 | 插件 页面、选项卡 Marketplace 中安装 从 JetBrains Marketplace 安装插件。

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

3. 下载、安装并配置 Docker ，如 Docker 中所述

4. 在 Docker 中配置 Node.js 远程解释器或通过 Docker Compose并 将其设置为默认在您的项目中。 还要确保与此远程解释器关联的软件包管理器 设置为项目默认。

5. 打开您的 package.json 并确保 Jest 在 devDependencies 部分列出：

   { "name": "node-express", "version": "0.0.0", "private": true, "dependencies": { "cookie-parser": "~1.4.4", "debug": "~2.6.9", "express": "~4.16.1", "http-errors": "~1.6.3", "morgan": "~1.9.1", "pug": "^3.0.2" }, "devDependencies": { "eslint": "^8.1.0", "http-server": "^14.0.0", "jest": "^27.3.1" } }

6. 在编辑器中的任意位置右键点击，然后从上下文菜单中选择 运行 '<package manager> install'。

运行测试

1. 根据 Jest 官方网站 上的说明创建测试。

2. 如同本地开发：直接从编辑器运行和调试单个测试，或者按照上面 运行测试 和 调试测试 中的描述创建一个运行/调试配置来启动部分或全部测试。