WebStorm 2025.2 Help

测试 TypeScript

从第 20 版开始,Node.js 自带稳定版本的 Node.js 内置测试运行器。 WebStorm 支持与内置测试运行器集成,因此可以在无需安装和配置任何第三方框架的情况下运行测试。

WebStorm 为 ts-nodetsx 加载器提供开箱即用的配置,因此可以在无需预先将 TypeScript 测试编译为 JavaScript 的情况下运行和调试。 或者,可以安装自定义加载器并按照 创建 Node.js Test Runner 运行/调试配置 中的说明进行配置。

您可以直接在编辑器中运行和调试测试,也可以启动类型为 Node.js 测试运行器 的运行/调试配置。

WebStorm 提供测试、测试对象与测试结果之间的各种导航功能,详情请参见 在测试与被测对象之间导航跳转到测试结果跳转到测试声明

开始之前

  1. 请确保在计算机上安装了版本为 20 或更高版本的 Node.js,并将其配置为 本地 Node.js 解释器

  2. 安装加载器。 在嵌入式 终端Alt+F12 )中输入:

    • npm install --save-dev ts-node 以安装 ts-node

    • npm install --save-dev tsx 以安装 tsx

从编辑器运行测试

  • 要运行测试,请单击其旁边标尺中的 运行测试图标 ,然后从列表中选择 运行 '<test name>'

    使用 Node.js 内置测试运行器从编辑器运行测试
  • 要运行套件中的所有测试,请单击其旁边标尺中的 全部运行图标 ,然后从列表中选择 运行 '<suite name>'

    使用 Node.js 内置测试运行器从编辑器运行套件

通过运行配置运行测试

通过运行/调试配置运行测试在需要从多个测试文件中运行测试时非常有用。 使用运行/调试配置的另一个优势是可以配置自定义加载器。

Node.js Test Runner 运行/调试配置

您可以自行创建运行/调试配置,或者保存、编辑并重复使用类型为 Node.js 测试运行器临时运行/调试配置 ,该配置在从编辑器运行测试或套件时由 WebStorm 创建。

  1. 转到 运行 | 编辑配置。 或者,从工具栏上的 运行 小组件中选择 编辑配置

    打开“编辑配置”对话框

    或者,选择先前生成的临时运行/调试配置。

  2. 在打开的 编辑配置 对话框中,点击工具栏上的 添加 按钮(添加按钮 ),并从列表中选择 Node.js 测试运行器

    将打开 运行/调试配置:Node.js 测试运行器 对话框。

  3. 指定要使用的 Node.js 解释器、工作目录并选择要运行的测试范围。

  4. 语言 列表中选择 TypeScript

  5. 加载器 列表中选择要使用的加载器。 默认情况下,提供与 tsxts -node 的集成。

    或者,安装并配置自定义加载器。 例如,安装 jiti 并在 Node 选项 字段中输入 -r jiti/register

    TypeScript 测试:配置自定义加载器
  6. 点击 运行

    或者,从 运行 小组件中选择现有的运行/调试配置,并单击其旁边的 调试图标

查看测试结果

测试结果显示在 运行 工具窗口中。

测试结果

详细了解请参阅 探索测试结果

重新运行测试

  • 要重新运行单个测试,在 运行 工具窗口中选择该测试,然后在其上下文菜单中选择 运行 '<test name>' 或按 Alt+Shift+R

    从“运行”工具窗口重新运行单个测试

    或者,使用测试旁的边距图标重新运行。 单击 运行被忽略测试图标重新运行失败测试图标重新运行成功测试图标 以重新运行被忽略、失败或成功的测试,并从列表中选择 运行 '<test name>'

    从标尺重新运行单个测试
  • 要重新运行整个套件,请单击套件旁的边距图标,然后从列表中选择 运行 '<suite name>'

    从标尺重新运行套件
  • 要重新运行上一会话中的所有测试,请在 运行 工具窗口的工具栏中单击 重新运行 '<suite name>' 图标

    重新运行测试套件

调试测试

  1. 根据需要设置 断点

  2. 开始调试:

    • 要调试测试,请单击测试旁边边距中的 运行测试图标 ,然后从列表中选择 调试 '<test name>'

    • 要调试套件中的所有测试,请单击该套件旁边边距中的 运行测试图标 ,然后从列表中选择 调试 '<suite name>'

      TypeScript 测试:从编辑器调试套件
    • 或者,创建一个类型为 Node.js 测试运行器 的运行/调试配置 如上所述 ,从 运行 小部件中选择它,然后单击其旁的 调试图标

      TypeScript 测试:通过运行/调试配置调试测试
最后修改日期: 2025年 9月 26日