selenium-java-junit-ulelement

About the project

The project showcases the use of Selenium with Java and JUnit for performing functional tests on an <ul> element.

Website¹

The website where the element is located is the https://oapen.org/ .

Web element under test

The web element tested was an <ul> element found on the landing page of the website:

OOP

To make full use of Java as a pure Object-Oriented language and, by extension, optimize code organization, a small class hierarchy was developed. Each subclass simulates a concrete user action.

Horizontal vs vertical testing

There are 4 test classes, each of which corresponds to a <li> sub-element of the <ul> element. Taking advantage of JUnit's ordering capabilities, the test classes are run according to a custom order (horizontal testing).

Ordering number	<li> sub-element	Test class
#1	'Subject' link	SubjectLinkTest
#2	'Publisher' link	PublisherLinkTest
#3	'Language' link	LanguageLinkTest
#4	'Collections' link	CollectionsLinkTest

Furthermore, each class contains test methods that correspond to a series of simulated steps per <li> sub-element. As in the case of the test classes, the test methods are run according to a custom order (vertical testing).

Prerequisites

• Java 17 or higher,
• Intellij IDEA (or any other Java IDE),
• Maven,
• Selenium.

Dependencies

  <dependencies>
    <!-- https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java -->
    <dependency>
      <groupId>org.seleniumhq.selenium</groupId>
      <artifactId>selenium-java</artifactId>
      <version>4.23.0</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-firefox-driver -->
    <dependency>
      <groupId>org.seleniumhq.selenium</groupId>
      <artifactId>selenium-firefox-driver</artifactId>
      <version>4.23.0</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-chrome-driver -->
    <dependency>
      <groupId>org.seleniumhq.selenium</groupId>
      <artifactId>selenium-chrome-driver</artifactId>
      <version>4.23.0</version>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter-engine -->
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-engine</artifactId>
      <version>5.10.3</version>
      <scope>test</scope>
    </dependency>

    <!-- https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter-api -->
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-api</artifactId>
      <version>5.10.3</version>
      <scope>test</scope>
    </dependency>

Further documentation

For more information, please check the provided javadoc.

Footnotes

1. Disclaimer: This website was tested in order to showcase the use of Selenium with Java and JUnit 5, and such testing does not constitute an endorsement or promotion of said website. ↩