Base test class pattern in Selenium Java - Build an Automation Script

Automate login test using base test class pattern

Preconditions (3)

Step 1: Open browser and navigate to login page URL

Step 2: Enter '[e-mail]' in the email input field

Step 3: Enter 'Test@1234' in the password input field

Step 4: Click the login button

Step 5: Verify that the user is redirected to the dashboard page URL

✅ Expected Result: User successfully logs in and dashboard page is displayed

Automation Requirements - Selenium WebDriver with JUnit 5

Assertions Needed:

Verify current URL matches expected dashboard URL after login

Best Practices:

Use a base test class to initialize and quit WebDriver

Use @BeforeEach and @AfterEach annotations for setup and teardown

Use explicit waits to handle page load and element visibility

Use meaningful locators (By.id, By.name) instead of brittle XPath

Keep test methods focused and readable

Automated Solution

Selenium Java

import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;

import java.time.Duration;

import static org.junit.jupiter.api.Assertions.assertEquals;

public class BaseTest {
    protected WebDriver driver;
    protected WebDriverWait wait;

    @BeforeEach
    public void setUp() {
        driver = new ChromeDriver();
        wait = new WebDriverWait(driver, Duration.ofSeconds(10));
        driver.manage().window().maximize();
    }

    @AfterEach
    public void tearDown() {
        if (driver != null) {
            driver.quit();
        }
    }
}

public class LoginTest extends BaseTest {
    private final String loginUrl = "https://example.com/login";
    private final String dashboardUrl = "https://example.com/dashboard";

    @Test
    public void testSuccessfulLogin() {
        driver.get(loginUrl);

        WebElement emailInput = wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("email")));
        emailInput.sendKeys("[e-mail]");

        WebElement passwordInput = driver.findElement(By.id("password"));
        passwordInput.sendKeys("Test@1234");

        WebElement loginButton = driver.findElement(By.id("loginButton"));
        loginButton.click();

        wait.until(ExpectedConditions.urlToBe(dashboardUrl));

        assertEquals(dashboardUrl, driver.getCurrentUrl(), "User should be redirected to dashboard after login");
    }
}

The BaseTest class sets up and tears down the WebDriver before and after each test. This avoids repeating setup code in every test class.

We use @BeforeEach to initialize the ChromeDriver and maximize the window. @AfterEach quits the driver to close the browser.

The LoginTest class extends BaseTest to reuse this setup. It navigates to the login page, waits for the email input to be visible, enters credentials, clicks login, and waits for the dashboard URL.

Assertions verify the final URL matches the expected dashboard URL, confirming successful login.

Explicit waits ensure elements are ready before interacting, preventing flaky tests.

Common Mistakes - 4 Pitfalls

Initializing WebDriver inside each test method instead of a base class

Using Thread.sleep() instead of explicit waits

Using brittle XPath locators like absolute paths

Not quitting WebDriver after tests

Bonus Challenge

Now add data-driven testing with 3 different sets of login credentials

Show Hint

Practice

1. What is the main purpose of using a Base Test Class in Selenium Java testing?

easy

A. To share common setup and cleanup code across multiple test classes

B. To write all test cases in a single class

C. To avoid using WebDriver in tests

D. To make tests run slower for debugging

Solution

1. Step 1: Understand the role of a base test class

   A base test class contains common setup and cleanup methods that multiple test classes can reuse.

2. Step 2: Identify the benefit of code reuse

   Sharing setup code avoids duplication and keeps tests organized and maintainable.

3. Final Answer:

   To share common setup and cleanup code across multiple test classes -> Option A

4. Quick Check:

   Base test class = shared setup/cleanup [OK]

Hint: Base class holds shared setup and teardown code [OK]

Common Mistakes:

• Thinking base class holds all tests
• Ignoring code reuse benefits
• Confusing base class with utility classes

2. Which of the following is the correct way to declare a base test class in Java for Selenium tests?

easy

A. public BaseTest { WebDriver driver; void setup() { } }

B. class BaseTest { void setup() { WebDriver driver = new WebDriver(); } }

C. public class BaseTest extends WebDriver { void setup() { } }

D. public class BaseTest { WebDriver driver; @BeforeEach void setup() { /* init driver */ } }

Solution

1. Step 1: Check Java class declaration syntax

   public class BaseTest { WebDriver driver; @BeforeEach void setup() { /* init driver */ } } correctly declares a public class with a WebDriver field and a setup method annotated with @BeforeEach.

2. Step 2: Identify errors in other options

   class BaseTest { void setup() { WebDriver driver = new WebDriver(); } } misses access modifiers and uses local driver variable incorrectly. public BaseTest { WebDriver driver; void setup() { } } lacks 'class' keyword. public class BaseTest extends WebDriver { void setup() { } } wrongly extends WebDriver, which is an interface.

3. Final Answer:

   public class BaseTest { WebDriver driver; @BeforeEach void setup() { /* init driver */ } } -> Option D

4. Quick Check:

   Correct class syntax with setup method = public class BaseTest { WebDriver driver; @BeforeEach void setup() { /* init driver */ } } [OK]

Hint: Look for public class with WebDriver and @BeforeEach setup [OK]

Common Mistakes:

• Missing 'public' keyword
• Incorrect class declaration syntax
• Extending WebDriver interface wrongly

3. Given the following base test class and child test class, what will be printed when running ChildTest.testExample()?

public class BaseTest {
    WebDriver driver;
    @BeforeEach
    void setup() {
        driver = new ChromeDriver();
        System.out.println("Setup done");
    }
    @AfterEach
    void teardown() {
        driver.quit();
        System.out.println("Teardown done");
    }
}

public class ChildTest extends BaseTest {
    @Test
    void testExample() {
        System.out.println("Test running");
    }
}

medium

A. Test running
Setup done
Teardown done

B. Setup done
Test running
Teardown done

C. Setup done
Teardown done
Test running

D. Test running
Teardown done
Setup done

Solution

1. Step 1: Understand JUnit lifecycle with base class

   @BeforeEach runs before each test method, @AfterEach runs after. ChildTest inherits these methods.

2. Step 2: Trace the output order

   First "Setup done" prints from setup(), then "Test running" from testExample(), finally "Teardown done" from teardown().

3. Final Answer:

   Setup done Test running Teardown done -> Option B

4. Quick Check:

   @BeforeEach -> test -> @AfterEach = Setup done Test running Teardown done [OK]

Hint: Remember: setup before test, teardown after test [OK]

Common Mistakes:

• Assuming setup runs after test
• Ignoring inheritance of setup/teardown
• Mixing order of print statements

4. Identify the error in this base test class code snippet:

public class BaseTest {
    WebDriver driver;
    @BeforeEach
    void setup() {
        driver = new ChromeDriver();
    }
    @AfterEach
    void teardown() {
        driver.close();
    }
}

medium

A. Using driver.close() instead of driver.quit() in teardown

B. Missing public keyword in class declaration

C. Not initializing WebDriver in setup method

D. Using @BeforeEach instead of @BeforeAll

Solution

1. Step 1: Understand difference between driver.close() and driver.quit()

   driver.close() closes current window, driver.quit() closes all windows and ends session.

2. Step 2: Identify best practice for cleanup

   In teardown, driver.quit() is preferred to fully close browser and free resources.

3. Final Answer:

   Using driver.close() instead of driver.quit() in teardown -> Option A

4. Quick Check:

   Proper cleanup uses driver.quit() [OK]

Hint: Use driver.quit() to fully close browser in teardown [OK]

Common Mistakes:

• Confusing driver.close() with driver.quit()
• Forgetting to quit WebDriver session
• Assuming driver.close() frees all resources

5. You want to create a base test class that initializes WebDriver only once before all tests run and quits it after all tests finish. Which JUnit 5 annotations should you use in the base class for setup and teardown methods?

hard

A. @BeforeAll for setup and @AfterEach for teardown with static setup only

B. @BeforeEach for setup and @AfterEach for teardown with instance methods

C. @BeforeAll for setup and @AfterAll for teardown with static methods

D. @BeforeEach for setup and @AfterAll for teardown with instance teardown

Solution

1. Step 1: Understand JUnit 5 lifecycle annotations

   @BeforeAll and @AfterAll run once before and after all tests; methods must be static by default.

2. Step 2: Match requirement to annotations

   To initialize WebDriver once before all tests and quit after all tests, use @BeforeAll and @AfterAll with static methods.

3. Final Answer:

   @BeforeAll for setup and @AfterAll for teardown with static methods -> Option C

4. Quick Check:

   One-time setup/teardown = @BeforeAll/@AfterAll static [OK]

Hint: Use @BeforeAll/@AfterAll static for one-time setup/teardown [OK]

Common Mistakes:

• Using @BeforeEach/@AfterEach for one-time setup
• Not making @BeforeAll/@AfterAll methods static
• Mixing instance and static lifecycle methods