Retry analyzer for failures in Selenium Java - Test Execution Trace

Test Overview

This test demonstrates how a retry analyzer works in Selenium with Java. It retries a failed test once before marking it as failed, verifying that the retry logic triggers on failure.

Test Code - TestNG with Selenium WebDriver

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.Assert;
import org.testng.IRetryAnalyzer;
import org.testng.ITestResult;
import org.testng.annotations.AfterClass;
import org.testng.annotations.BeforeClass;
import org.testng.annotations.Test;

public class RetryAnalyzerExample {

    WebDriver driver;

    @BeforeClass
    public void setup() {
        driver = new ChromeDriver();
        driver.get("https://example.com/login");
    }

    @Test(retryAnalyzer = Retry.class)
    public void testLogin() {
        WebElement username = driver.findElement(By.id("username"));
        WebElement password = driver.findElement(By.id("password"));
        WebElement loginButton = driver.findElement(By.id("loginBtn"));

        username.sendKeys("wrongUser");
        password.sendKeys("wrongPass");
        loginButton.click();

        WebElement errorMsg = driver.findElement(By.id("errorMsg"));
        Assert.assertTrue(errorMsg.isDisplayed(), "Error message should be displayed for invalid login");
    }

    @AfterClass
    public void teardown() {
        driver.quit();
    }

    public static class Retry implements IRetryAnalyzer {
        private int retryCount = 0;
        private static final int maxRetryCount = 1;

        @Override
        public boolean retry(ITestResult result) {
            if (retryCount < maxRetryCount) {
                retryCount++;
                return true;
            }
            return false;
        }
    }
}

Execution Trace - 9 Steps

Step	Action	System State	Assertion	Result
1	Test starts and Chrome browser opens	Browser opened at https://example.com/login page	—	PASS
2	Find username, password fields and login button	Login form elements are located on the page	—	PASS
3	Enter invalid username and password, then click login	Login form submitted with wrong credentials	—	PASS
4	Find error message element on page	Error message element located	Check if error message is displayed	FAIL
5	Retry analyzer triggers retry of testLogin	Test restarts: browser still open at login page	—	PASS
6	Repeat steps: find elements, enter invalid credentials, click login	Login form submitted again with wrong credentials	—	PASS
7	Find error message element again	Error message element located	Check if error message is displayed	PASS
8	Test completes successfully after retry	Test marked as pass	—	PASS
9	Browser closes	Browser closed	—	PASS

Failure Scenario

Failing Condition: Error message element is not found or not displayed after retry

Execution Trace Quiz - 3 Questions

What does the retry analyzer do when the test fails the first time?

A It retries the test once before marking it failed

B It immediately marks the test as failed without retry

C It retries the test infinitely until it passes

D It skips the test after failure

Key Result

Using a retry analyzer helps reduce false negatives by rerunning failed tests automatically once, improving test reliability without manual intervention.

Practice

1. What is the main purpose of a RetryAnalyzer in Selenium Java testing?

easy

A. To set up browser configurations before tests

B. To generate test reports after execution

C. To automatically rerun failed tests to reduce false failures

D. To locate web elements on the page

Solution

1. Step 1: Understand the role of RetryAnalyzer

   The RetryAnalyzer reruns tests that fail to handle temporary issues like network delays.

2. Step 2: Compare with other options

   Generating reports, locating elements, and setting browser configs are unrelated to retrying failed tests.

3. Final Answer:

   To automatically rerun failed tests to reduce false failures -> Option C

4. Quick Check:

   RetryAnalyzer reruns failed tests [OK]

Hint: RetryAnalyzer reruns failed tests automatically [OK]

Common Mistakes:

• Confusing RetryAnalyzer with report generation
• Thinking RetryAnalyzer locates elements
• Assuming RetryAnalyzer sets browser options

2. Which method must be overridden when implementing a RetryAnalyzer in Selenium Java?

easy

A. retry(ITestResult result)

B. onTestStart()

C. beforeMethod()

D. afterTest()

Solution

1. Step 1: Identify RetryAnalyzer interface method

   The IRetryAnalyzer interface requires overriding the retry(ITestResult result) method to decide if a test should rerun.

2. Step 2: Exclude unrelated methods

   Methods like onTestStart(), beforeMethod(), and afterTest() belong to other TestNG listeners or annotations, not RetryAnalyzer.

3. Final Answer:

   retry(ITestResult result) -> Option A

4. Quick Check:

   Override retry(ITestResult) method [OK]

Hint: Override retry(ITestResult) to rerun tests [OK]

Common Mistakes:

• Overriding wrong listener methods
• Confusing RetryAnalyzer with TestNG listeners
• Using before/after test methods instead

3. Given this RetryAnalyzer code snippet, what will be the output if the test fails twice and maxRetryCount is 2?

public class Retry implements IRetryAnalyzer {
  private int count = 0;
  private static final int maxRetryCount = 2;

  public boolean retry(ITestResult result) {
    if (count < maxRetryCount) {
      count++;
      return true;
    }
    return false;
  }
}

medium

A. The test will rerun twice after the first failure

B. The test will rerun only once after the first failure

C. The test will not rerun at all

D. The test will rerun three times after the first failure

Solution

1. Step 1: Analyze retry logic and count

   The retry method allows rerun while count is less than maxRetryCount (2). It increments count each retry.

2. Step 2: Count reruns for failures

   On first failure, count=0 < 2, rerun allowed (count=1). On second failure, count=1 < 2, rerun allowed (count=2). On third failure, count=2 not < 2, no rerun.

3. Final Answer:

   The test will rerun twice after the first failure -> Option A

4. Quick Check:

   maxRetryCount=2 means 2 reruns allowed [OK]

Hint: Count < maxRetryCount means rerun allowed [OK]

Common Mistakes:

• Assuming rerun count equals maxRetryCount + 1
• Confusing count increment timing
• Thinking no reruns happen

4. Identify the error in this RetryAnalyzer implementation:

public class Retry implements IRetryAnalyzer {
  private int count = 0;
  private static final int maxRetryCount = 3;

  public boolean retry(ITestResult result) {
    if (count <= maxRetryCount) {
      count++;
      return true;
    }
    return false;
  }
}

medium

A. maxRetryCount should be a non-final variable

B. The count variable should be static

C. The retry method should return void

D. The condition should be count < maxRetryCount, not <=

Solution

1. Step 1: Check retry condition logic

   The condition count <= maxRetryCount allows one extra retry than intended because count starts at 0.

2. Step 2: Correct condition for retry limit

   Using count < maxRetryCount ensures retries happen exactly maxRetryCount times.

3. Final Answer:

   The condition should be count < maxRetryCount, not <= -> Option D

4. Quick Check:

   Use < not <= for retry count limit [OK]

Hint: Use count < maxRetryCount to avoid extra retry [OK]

Common Mistakes:

• Using <= causes one extra retry
• Making count static unnecessarily
• Wrong return type for retry method

5. You want to implement a RetryAnalyzer that retries a failed test only if the failure is caused by a TimeoutException. Which approach is correct?

hard

A. Always return true in retry(ITestResult result) to retry all failures

B. Check the exception type in retry(ITestResult result) and return true only if it is TimeoutException

C. Use a separate listener to rerun tests instead of RetryAnalyzer

D. RetryAnalyzer cannot check exception types; use test annotations instead

Solution

1. Step 1: Understand RetryAnalyzer capabilities

   The retry method receives ITestResult, which contains the exception causing failure.

2. Step 2: Implement conditional retry logic

   Check if result.getThrowable() is instance of TimeoutException. Return true to retry only in that case.

3. Final Answer:

   Check the exception type in retry(ITestResult result) and return true only if it is TimeoutException -> Option B

4. Quick Check:

   Retry only on TimeoutException by checking exception type [OK]

Hint: Check exception type in retry method to conditionally retry [OK]

Common Mistakes:

• Retrying all failures without condition
• Using listeners instead of RetryAnalyzer for retry
• Assuming RetryAnalyzer cannot access exception info