WebStorm 2025.2 Help

Protractor

Protractor 是一个用于 AngularAngularJS 应用程序的测试框架。 Protractor 会在真实浏览器中对您的应用程序运行测试,确保测试结果的正确性和可靠性。 WebStorm 集成了 Protractor,因此您可以在 IDE 中直接运行和调试测试。 您可以在树状视图中查看测试结果,并从中轻松导航至测试源文件。

开始之前

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

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

安装 Protractor

您可以在项目中本地安装 Protractor 或进行全局安装。推荐使用全局安装。 推荐使用全局安装。

全局安装 Protractor

  1. 在嵌入的 终端Alt+F12 )中输入:

    npm install -g protractor

  2. 若要下载必要的二进制文件,请输入 webdriver-manager update。 另请参阅 Protractor 官方网站的入门教程

运行测试

Protractor 测试只能通过运行/调试配置启动。

创建 Protractor 运行配置

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

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

    如果选择 项目 别名,WebStorm 将自动使用 Node 解释器 字段中指定的项目默认解释器,该字段位于 Node.js 页面。 在大多数情况下,WebStorm 会检测项目默认解释器并自动填入该字段。

    您也可以选择其他已配置的本地或远程解释器,或点击 浏览按钮 配置新的解释器。

    有关更多信息,请参阅 配置远程 Node.js 解释器配置本地 Node.js 解释器在 Windows 子系统 Linux 上使用 Node.js

  3. 指定 protractor 软件包的位置和 protractor.conf.js 配置文件的路径。 如果按照标准安装过程操作,WebStorm 会检测所有路径并在相应字段中显示。

  4. 指定要运行的测试。 可以是某个特定测试或测试套件、整个测试文件,或包含多个测试文件的文件夹。

通过运行配置运行测试

  1. 手动启动 Selenium Server,或在 protractor.conf.js 中配置为自动启动。 有关更多信息,请参阅 Protractor 官方网站

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

    选择运行/调试配置
  3. <current_run_configuration_name> 选项卡的 运行 工具窗口中查看并分析服务器消息。

导航

借助 WebStorm,您可以在文件与其对应的测试文件之间,或从 测试运行窗口 中的测试结果跳转到对应测试。

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

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

调试测试

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

开始调试测试

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

  2. 从配置列表中选择 Protractor 运行/调试配置,然后在列表中或工具栏上点击 带覆盖率运行

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

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