Retry analyzer for failures in Selenium Java

Introduction

Sometimes tests fail because of temporary problems. Retry analyzer helps run the test again automatically to check if it passes on retry.

When a test fails due to slow loading of a web page.

When a test fails because of a temporary network glitch.

When a test intermittently fails due to timing issues.

When you want to reduce false test failures caused by flaky tests.

Syntax

Selenium Java

public class RetryAnalyzer implements IRetryAnalyzer {
    private int count = 0;
    private static final int maxTry = 3;

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

This class implements the IRetryAnalyzer interface from TestNG.

The retry method returns true to retry the test, false to stop retrying.

Examples

This retry analyzer retries a failed test up to 2 times.

Selenium Java

public class RetryAnalyzer implements IRetryAnalyzer {
    private int count = 0;
    private static final int maxTry = 2;

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

This test uses the retry analyzer to rerun if it fails.

Selenium Java

@Test(retryAnalyzer = RetryAnalyzer.class)
public void testExample() {
    Assert.assertTrue(new java.util.Random().nextBoolean());
}

Sample Program

This test sometimes fails randomly. The retry analyzer will retry it up to 2 times if it fails.

Selenium Java

import org.testng.Assert;
import org.testng.ITestResult;
import org.testng.annotations.Test;
import org.testng.IRetryAnalyzer;

public class RetryAnalyzer implements IRetryAnalyzer {
    private int count = 0;
    private static final int maxTry = 2;

    @Override
    public boolean retry(ITestResult result) {
        if (count < maxTry) {
            count++;
            System.out.println("Retrying test " + result.getName() + " for " + count + " time(s)");
            return true;
        }
        return false;
    }
}

public class SampleTest {

    @Test(retryAnalyzer = RetryAnalyzer.class)
    public void flakyTest() {
        boolean pass = Math.random() > 0.7; // 30% chance to fail
        System.out.println("Test run, pass? " + pass);
        Assert.assertTrue(pass, "Random failure");
    }
}

Important Notes

Retry analyzer only retries failed tests, not passed ones.

Use retry analyzer carefully to avoid hiding real bugs.

Print statements help see retry attempts in console output.

Summary

Retry analyzer helps rerun failed tests automatically.

It reduces false failures caused by temporary issues.

Implemented by overriding retry method from IRetryAnalyzer.

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