Protractor
Protractor is a test framework for Angular and AngularJS applications. Protractor executes tests against your application running in a real browser, which ensures correctness and trustworthiness of test results. JetBrains Rider integrates with Protractor so you can run and debug your tests from inside the IDE. You can see the test results in a treeview and easily navigate to the test source from there.
Installing Protractor
You can install Protractor locally, in your project, or globally. Global installation is preferable.
To install Protractor globally
Open the built-in JetBrains Rider Terminal (Ctrl+Alt+1) and type
npm install -g protractor
at the command prompt.
To download the necessary binaries, type
webdriver-manager update
. See also Getting Started on the Protractor official website.
Running tests
Protractor tests are launched only through a run/debug configuration.
To create a Protractor run configuration
Open the Run/Debug Configuration dialog box ( on the main menu). Click on the toolbar and select Protractor from the list. The Run/Debug Configuration: Protractor dialog box opens.
Specify the Node.js interpreter to use. This can be a local Node.js interpreter or a Node.js on Windows Subsystem for Linux.
Specify the location of the
protractor
package and the path to theprotractor.conf.js
configuration file. If you followed the standard installation, JetBrains Rider detects all these paths and displays them in the corresponding fields.
To run tests via a run configuration
Start the Selenium Server manually or configure it to start automatically in
protractor.conf.js
. For details, see the Protractor Official website.Select the Protractor run/debug configuration from the list on the main toolbar and click to the right of the list.
View and analyze messages from the server in the <current_run_configuration_name> tab of the Run tool window.
Navigation
With JetBrains Rider, you can jump between a file and the related test file. Navigation from a test result in the Test Runner Tab to the test is also supported.
To jump between a file and the related test file
Open the file in the editor and choose
or on the context menu, or just press N/A.
To jump from a test result to the test
Select the test name in the Test Runner tab and choose Jump to Source on the context menu. The test file opens in the editor with the cursor placed at the test definition.
Debugging tests
A debugging session for Protractor tests is started only through a run/debug configuration.
To start debugging tests
Create a Protractor run/debug configuration as described above.
Select the Protractor run/debug configuration from the list on the main toolbar and click to the right of the list.
In the Debug window that opens, proceed as usual: step through the tests, stop and resume test execution, examine the test when suspended, etc.