Perform tests

Last modified: 14 April 2021

Run the selected test or test folder: Ctrl+Shift+F10

Stop the current test session: Ctrl+F2

RubyMine provides a convenient way to run and debug tests: you can run them from a context menu of a test file or directory containing tests, execute specific tests from the editor's gutter or by using intention actions, and so on. All of these actions create test run/debug configurations. You can use run/debug configurations to run specific subsets of tests with customized parameters.

https://resources.jetbrains.com/help/img/idea/2021.1/rm_get_started_tests_result.png
Gif

Run tests

Run tests from the Project view

To run a test or multiple tests from the Project view Alt+1, follow the steps below:

  1. Right-click a specific test file or a directory containing the required tests, for example, test, spec, or features.

  2. From the context menu, select Run 'All tests in <directory name>' or Run 'All specs in <directory name>' depending on the used testing framework.

    Run all tests in a directory

Run tests from the editor

To run tests from the editor, perform the following steps:

  1. In the test file, do one of the following:

    • Click the Run button on the gutter next to the required test or test class.

      Run a specific test

    • Place the caret at the required test or test class name and press Alt+Enter.

  2. Select Run '<test name>' and press Enter.

RubyMine will run and display test results in the Run tool window. If some tests are failed, you can rerun them. Learn how to explore test results from View and explore test results.

After you've run tests, RubyMine automatically creates a special profile - a temporary run/debug configuration. You can customize settings of this configuration, for example, you can pass task arguments, specify environment variables, and so on. Then, you can save the customized configuration to quickly run this configuration in the future.

Run tests using Rake tasks

To run tests using a Rake task, perform the following steps:

tip

RubyMine automatically creates the Rake run configurations for running the Minitest and RSpec tests in Rails applications - test and spec. Learn how to run code using configurations from Run tests using a predefined configuration.

Run tests using a predefined configuration

To run the test(s) using the already created run configuration, do one of the following:

Rerun tests

Rerun a testing session

  • Press Ctrl+F5 or click the Rerun button the Run button on the toolbar of Run tool window.

Rerun an individual test

  • In the Run tool window, right-click the test and select Run <test_target>.

Rerun tests automatically

RubyMine lets you rerun run/debug configuration of a test automatically, if the source code has been changed.

  • Press the Toggle auto-test button the Toggle Auto-Test button on the Run tool window.

Rerun failed tests

RubyMine lets you rerun the failed tests only, instead of rerunning all the tests.

  • To rerun failed tests, click the Rerun Failed Tests button the Rerun Failed Tests button on the Run tool window.

Debug failed tests

  1. Place a breakpoint in the failed test.

  2. In the Run tool window, press Shift and click the Rerun Failed Tests button The Rerun Failed Tests button.

  3. Select Debug from the Restart Failed Tests popup.

Stop running tests

See also

Reference