# Protractor

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

[Protractor](http://www.protractortest.org) 是一个用于 [Angular](https://angular.io/) 和 [AngularJS](http://angularjs.org/) 应用程序的测试框架。 Protractor 在实际浏览器中对您的应用程序执行测试，从而确保测试结果的正确性和可信度。 CLion 与 Protractor 集成，所以您可以在 IDE 内运行和调试您的测试。 您可以在树形视图中查看测试结果，并轻松从那里导航到测试源代码。

## 在开始之前

Procedure:

1. 请确保您的计算机上安装了 [Node.js](http://nodejs.org/)。

2. 确保所需的  JavaScript 和 TypeScript  以及  Angular 和 AngularJS  插件已在   设置 | 插件   页面上启用。 有关更多信息，请参阅 [管理插件](managing-plugins.html)。

## 安装 Protractor

您可以在本地、项目中或全局安装 Protractor。 全局安装是首选。

Procedure: 全局安装 Protractor

1. 在命令行 shell 或嵌入式   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）中输入：

`npm install -g protractor`

2. 要下载必要的二进制文件，请输入  `webdriver-manager update` 。 另请参阅 [Protractor 官方网站上的入门指南](http://www.protractortest.org/#/)。

## 运行测试

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

Procedure: 创建一个 Protractor 运行配置

1. 打开 [运行/调试配置](run-debug-configurations-dialog.html)对话框（  `运行 | 编辑配置` 在主菜单中），点击 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置：Protractor](run-debug-configuration-protractor.html)对话框打开。

> **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)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中选择一个测试文件，然后从上下文菜单中选择   创建 <文件名>  。

2. 指定要使用的 Node.js 运行时。

如果您选择   项目   别名， CLion 将自动使用在 [JavaScript 运行时](javascript-runtime.html) 页面上   Node.js 运行时   字段中的项目默认解释器。 在大多数情况下， CLion 会检测到项目的默认运行时，并自动填写该字段。

您还可以选择另一个已配置的本地解释器，或点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 并配置一个新的。

3. 指定  protractor  包的位置和  `protractor.conf.js`  配置文件的路径。 如果您按照标准安装进行操作，CLion 会检测到所有这些路径并将它们显示在相应的字段中。

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

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

1. 手动启动 Selenium 服务器 或将其配置为在  `protractor.conf.js`  自动启动。 如需更多信息，请参见 [Protractor 官方网站](https://www.protractortest.org/#/tutorial#setup)。

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

3. 在   <current_run_configuration_name>   选项卡中的   运行   工具窗口，查看和分析来自服务器的消息。

## 导航

使用 CLion ，您可以在文件与相关测试文件之间跳转，或从 [测试运行器选项卡](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)), `⌘ ⇧ T` (Xcode), `Ctrl+Shift+T` (Visual Studio), `Ctrl+Shift+T` (Visual Studio (macOS)), `Ctrl+Shift+T` (ReSharper), `Ctrl+Shift+T` (ReSharper (macOS)), `Ctrl+Shift+T` (QtCreator), `Ctrl+Shift+T` (QtCreator (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)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))。 测试文件在编辑器中打开时，文本光标放置在测试定义处。

## 调试测试

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

Procedure: 开始调试测试

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

2. 从配置列表中选择 Protractor 运行/调试配置，并点击 ![运行覆盖率](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) 在列表或工具栏上。

3. 在打开的 [调试工具窗口](debug-tool-window.html) 中，按常规操作： [逐步执行程序](stepping-through-the-program.html)， [停止并恢复](null) 程序执行， [在挂起时检查程序](examining-suspended-program.html)，探索调用堆栈和变量，设置监视，评估变量， [查看实际 HTML DOM](viewing-actual-html-dom.html) 等。

要忽略源代码映射并逐步执行实际运行的代码，请在   调试   工具窗口的工具栏上按 ![禁用源代码映射切换按钮](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置：Protractor](run-debug-configuration-protractor.html)

