JSTestDriver

• Install and enable the JSTestDriver plugin on the Settings | Plugins page, tab Marketplace, as described in Installing plugins from JetBrains Marketplace.

  Through this plugin, WebStorm provides the JSTestDriver server and the assertion framework. During the test creation, the plugin detects the unit testing framework and suggests the Add <test framework> support intention action.

1. Download the framework of your choice and configure it as a WebStorm JavaScript library.

2. Do one of the following:

   • Add the project folder to the library scope.

   • Enable the framework support on-the-fly during test creation using the Add <test framework> support intention action.

   • To use Jasmine, add jasmine-jstd-adapter to the configuration file.

     Open jsTestDriver.conf and type the following code in it:

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

1. In the Project tree, select the parent folder of the production and test folders, and choose New | File from the context menu.

2. In the New File dialog that opens, type the name of the configuration file with the extension .jstd or .conf.

3. Open the new file in the editor and specify the full path to the current folder and the paths to the files to load relative to it. Use wildcards in file name patterns.

4. Complete the configuration file using YAML, refer to description of test runner configuration files.

• Click or in the left gutter and choose Run <test_name> from the list.

• You can also see whether a test has passed or failed right in the editor, thanks to the test status icons and in the gutter.

tip

The arrows appear only if the test framework used in your tests is associated with the project, so WebStorm can recognize the tests.

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

   tip

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

2. Specify the tests to run, the path to the configuration file, and the activities to perform before test execution.

1. Make sure you have at least one configuration file in your project.

2. Open the JSTestDriver Server tool window (View | Tool Windows | JSTestDriver Server), and click on the toolbar.

tip

To use a test server running on another machine or listening to a custom port, start it according to the server-specific instructions and specify its URL address in the Server area of the Run/Debug Configuration: JSTestDriver dialog.

• Click on the toolbar.

1. Start the JSTestDriver Server if it is not running yet and then switch to the JSTestDriver Server tool window.

2. To start a local browser with the Remote Console of the JSTestDriver, do one of the following:

   • Click the icon that indicates the browser of your choice.

   • If the browser is already opened, copy the contents of the Capture a browser using the URL read-only field and paste the URL in the address bar.

   In either case, the icon that indicates the chosen browser becomes active.

3. Switch to the JSTestDriver Server tool window and click the icon that indicates the browser you just opened. WebStorm displays a message informing you that it is ready for executing tests.

1. Select the JSTestDriver run/debug configuration from the list of configurations and click   in the list or on the toolbar.

   

2. Monitor test execution and analyze test results in the Test Runner tab of the Run tool window. For more information, refer to Explore test results.

• 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 CtrlShift0T.

• 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 caret placed at the test definition.

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

2. Select the JSTestDriver run/debug configuration from the list of configurations and click   in the list or on the toolbar.

   

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.

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

2. Start the JSTestDriver server and capture a browser to run the tests in.

3. Select the JSTestDriver run/debug configuration from the list of configurations and click   in the list or on the toolbar.

   

4. Monitor the code coverage in the Coverage tool window.

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

2. In the Coverage tab, specify the paths to the files to exclude.