IntelliJ IDEA 2022.3 Help


Selenium is a framework for automating tests in web applications.

Selenium support allows you to create a dedicated project for automated tests in Java, Kotlin, Groovy, and Python. You can choose Maven or Gradle for dependency management. For managing test cases, you can select TestNG or JUnit.

Selenium UI Testing plugin provides code highlighting, inspections and code completion in tests, validation for various configuration files, and icons in the gutter for easier navigation. For a full description of features, refer to Introducing Selenium Support in IntelliJ IDEA.

Install the Selenium UI Testing plugin

  1. In the Settings dialog (Ctrl+Alt+S), select Plugins.

  2. Switch to the Marketplace tab, type Selenium UI Testing, and click Install.

  3. Apply the changes and close the dialog. Restart the IDE if prompted.

Installing the Selenium UI Testing plugin plugin

Create a new Selenium project

  1. From the main menu, select File | New | Project.

    Otherwise, if you're on the Welcome screen, click New Project.

  2. From the list on the left, select Selenium.

  3. Name the new project and change its location if necessary.

  4. Select the Create Git repository to place the new project under version control.

    You will be able to do it later at any time.

  5. From the Language list, select the language that you want to use in your application.

  6. Select the build system that you want to use in your project: Maven or Gradle.

  7. From the JDK list, select the JDK that you want to use in your project.

    If the JDK is installed on your computer, but not defined in the IDE, select Add JDK and specify the path to the JDK home directory.

    If you don't have the necessary JDK on your computer, select Download JDK.

  8. Optionally, enable the Add sample code option and click Next.

    Creating a new Selenium project
  9. Select other frameworks and libraries that you want to install.

    This step is optional. You will be able to add the necessary libraries any time later. Click Create

A new project is created with a predefined folder structure according to the options that you have selected and adds a source and a test file.

A new Selenium project

Coding assistance for CSS and XPath

Selenium UI Testing plugin provides coding assistance for XPath and CSS, which are used in Selenium API as well as in many other libraries for UI testing. This includes syntax error highlighting in selectors as you type and code completion for standard CSS/HTML elements.

Code completion in Selenium XPath file

Selenium UI Testing plugin also provides coding assistance for JavaScript fragments, HTML tags and CSS properties, Selenium Grid 3 configuration files, Selenoid configuration files, and Allure Framework annotations. For more information, refer to Introducing Selenium Support in IntelliJ IDEA.

Run your tests

Place the caret at the test class to run all tests in that class, or at the test method, and press Ctrl+Shift+F10. Alternatively, click the the Run button gutter icon next to the test class or test method. For more information, refer to Run tests.

Running a test

When the tests finish running, the results are displayed on the Test Runner tab of the Run tool window. On this tab, you can rerun tests, export and import test results, see how much time it took to run each test, and so on. For more information, refer to Explore test results.

Use Selenoid for cross-browser testing

Selenoid is an implementation of the Selenium hub for Docker, which allows you to execute automated tests on web browsers running in Docker containers. For each test, Selenoid creates a container with the specified web browser, environment, and settings.

Run Selenoid on Docker

  1. Open the browsers.json file in the editor.

  2. On the panel above the editor, click Launch.

    Running Selenoid on Docker

The IDE will pull all the required containers with the browsers, and run the main Selenoid container to manage them.

Running Selenoid on Docker

There are additional options available in the Selenoid run configuration settings, such as output destination folders for logs and videos. To access these options, click Configure on the pane above the editor when the browsers.json file is opened. For the detailed description of the options, refer to Docker run configurations.

Selenium run/debug configuration
Last modified: 17 October 2022