Protractor

1. Download and install Node.js.

   warning

   Debugging of Angular applications is only supported with Node.js version 16 and earlier.

2. Make sure the JavaScript and TypeScript plugin is enabled in the settings. Press Ctrl+Alt+S to open the IDE settings and select Plugins. Click the Installed tab. In the search field, type JavaScript and TypeScript. For more details about plugins, see Managing plugins.

3. Install and enable the Angular and AngularJS plugin on the Preferences | Plugins page, tab Marketplace, as described in Installing plugins from JetBrains repository.

To install Protractor globally

1. In the embedded Terminal (Alt+F12) , type:

   npm install -g protractor

2. To download the necessary binaries, type webdriver-manager update. See also Getting Started on the Protractor official website.

To create a Protractor run configuration

1. Open the Run/Debug Configuration dialog (Run | Edit Configurations on the main menu), click in the left-hand pane, and select Protractor from the list. The Run/Debug Configuration: Protractor dialog opens.

   tip

   Alternatively, select a test file in the Project tool window and select Create <filename> from the context menu.

2. Specify the Node.js interpreter to use.

   If you choose the Project alias, AppCode will automatically use the project default interpreter from the Node interpreter field on the Node.js page . In most cases, AppCode detects the project default interpreter and fills in the field itself.

   You can also choose another configured local interpreter or click and configure a new one.

3. Specify the location of the protractor package and the path to the protractor.conf.js configuration file. If you followed the standard installation, AppCode detects all these paths and displays them in the corresponding fields.

4. Specify the tests to run. This can be a specific test or suite, an entire test file, or a folder with test files.

To run tests via a run configuration

1. Start the Selenium Server manually or configure it to start automatically in protractor.conf.js. For details, see the Protractor official website.

2. Select the Protractor run/debug configuration from the list on the main toolbar and click  to the right of the list.

3. View and analyze messages from the server in the <current_run_configuration_name> tab of the Run tool window.

• To jump between a test and its subject or vice versa, open the file in the editor and select Go to | Test or Go to | Test Subject from the context menu, or just press Ctrl+Shift+T.

• To jump from a test result to the test definition, click the test name in the Test Runner tab twice, or select Jump to Source from the context menu, or just press F4. The test file opens in the editor with the cursor placed at the test definition.

To start debugging tests

1. Create a Protractor run/debug configuration as described above.

2. Select the Protractor run/debug configuration from the list on the main toolbar and click  to the right of the list.

3. In the Debug tool window that opens, proceed as usual: step through the tests, stop and resume test execution, examine the test when suspended, run JavaScript code snippets in the Console, and so on.