PyCharm 2025.3 Help

JSTestDriver

PyCharm 支持与 JSTestDriver 测试框架 集成。

开始之前

  • 设置 | 插件 页面、 Marketplace 选项卡上安装并启用 JSTestDriver 插件,如 从 JetBrains Marketplace 安装插件 中所述。

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

在项目中配置测试框架

  1. 下载您选择的框架,并将其 配置为 一个 PyCharm JavaScript 库

  2. 执行以下任一操作:

    • 将项目文件夹添加到库范围

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

    • 要使用 Jasmine,请将 jasmine-jstd-adapter 添加到配置文件中。

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

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

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

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

创建配置文件

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

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

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

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

运行测试

PyCharm 允许您直接在编辑器中快速运行单个 JSTestDriver 测试,或创建运行/调试配置以执行部分或全部测试。

从编辑器运行单个测试

  • 在左侧装订区域中点击 运行按钮重新运行按钮 ,并从列表中选择 运行 <test_name>

  • 您还可以直接在编辑器中查看测试是否通过或失败,这得益于装订区域中的 测试状态 图标 测试通过测试失败

创建 JSTestDriver 运行配置

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

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

启动 WebStorm 默认的 JSTestDriver 测试服务器

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

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

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

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

捕获浏览器

  1. 如果尚未运行,请 启动 JSTestDriver 服务器 ,然后切换到 JSTestDriver 服务器 工具窗口。

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

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

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

    在任一情况下,表示所选浏览器的图标都会变为活动状态。

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

通过运行配置运行测试

  1. 从配置列表中选择 JSTestDriver 运行/调试配置,然后在列表或工具栏中点击 运行图标 &#xa0;。

  2. 运行 工具窗口的 测试运行器 选项卡中监视测试执行并分析测试结果。 有关详细信息,请参阅 探索测试结果

导航

使用 PyCharm,您可以在文件与相关测试文件之间跳转,或从 测试运行器选项卡 中的测试结果跳转到该测试。

  • 要在测试与其被测对象之间相互跳转,请在编辑器中打开该文件,并从上下文菜单中选择 转到 | 测试(S)转到 | 被测对象 ,或直接按 Ctrl+Shift+T

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

调试测试

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

开始调试测试

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

  2. 从配置列表中选择 JSTestDriver 运行/调试配置,然后在列表或工具栏中点击 调试图标 &#xa0;。

  3. 在打开的 调试工具窗口 中,按常规方式进行操作: 逐步执行程序停止并恢复程序执行、 在暂停时进行检查 、查看调用堆栈和变量、设置监视、对变量求值、 查看实际 HTML DOM ,等等。

监视代码覆盖率

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

使用覆盖率运行测试

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

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

  3. 从配置列表中选择 JSTestDriver 运行/调试配置,然后在列表或工具栏中点击 使用覆盖率运行图标 &#xa0;。

  4. 覆盖率 工具窗口中监视代码覆盖率。

从覆盖率分析中排除文件

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

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

最后修改日期: 2025年 12月 2日