edu.uci.qa.browserdriver.testing

Class ScreenshotTestWatcher

java.lang.Object

org.junit.rules.TestWatcher

edu.uci.qa.browserdriver.testing.BrowserTestWatcher

edu.uci.qa.browserdriver.testing.ScreenshotTestWatcher

All Implemented Interfaces:

org.junit.rules.TestRule

public class ScreenshotTestWatcher
extends BrowserTestWatcher

This JUnit watcher takes a screenshot of the browser on test failure. Screenshot saved in the fails folder located in BrowserConfig.getSaveFolder()/screenshots. Screenshot will also be logged to the current tests report if there is an active test.

Note that when using this watcher, do not quit the browser. If the browser has been quit during the test or in an @After, this watcher will do nothing!

Example usage of this watcher:

 
 
 import org.junit.*;
 import org.openqa.selenium.By;
 import org.openqa.selenium.support.ui.ExpectedConditions;
 
 import edu.uci.qa.browserdriver.BrowserDriver;
 import edu.uci.qa.browserdriver.testing.BrowserProvider;
 import edu.uci.qa.browserdriver.testing.ScreenshotTestWatcher;
 
 public class ScreenshotTest implements BrowserProvider {
     BrowserDriver driver = null;
     
      @Rule
     public ScreenshotTestWatcher watcher = new ScreenshotTestWatcher(this);
     
      @Before
     public void createBrowser() {
         driver = BrowserDriver.createBrowser();
     }
     
      @Test
     public void basicTest() throws Throwable {
         driver.get("http://www.google.com");
         driver.sendKeys(By.xpath("//*[ @name='q']"), "webdriver").submit();
         driver.waitUntil(
             ExpectedConditions.presenceOfElementLocated(
                 By.xpath("//*[ @id='rso' or  @id='resultStats']")));
         Assert.assertEquals("WRONG", driver.getTitle()); // This assert will always fail!
     }
 
      @Override
     public BrowserDriver getBrowser() {
         return driver;
     }
 }
 
 

Field Summary

Fields

Modifier and Type	Field and Description
protected Screenshot	failShot

Fields inherited from class edu.uci.qa.browserdriver.testing.BrowserTestWatcher

provider, verboseMode

Constructor Summary

Constructors

Constructor and Description
ScreenshotTestWatcher(BrowserProvider provider)
ScreenshotTestWatcher(BrowserProvider provider, boolean verboseMode)

Method Summary

Modifier and Type	Method and Description
protected void	failed(Throwable e, org.junit.runner.Description description)
protected void	skipped(org.junit.AssumptionViolatedException e, org.junit.runner.Description description)
protected void	succeeded(org.junit.runner.Description description)

Methods inherited from class org.junit.rules.TestWatcher

apply, finished, skipped, starting

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

failShot

protected Screenshot failShot

Constructor Detail

ScreenshotTestWatcher

public ScreenshotTestWatcher(BrowserProvider provider)

ScreenshotTestWatcher

public ScreenshotTestWatcher(BrowserProvider provider,
                             boolean verboseMode)

Method Detail

succeeded

protected void succeeded(org.junit.runner.Description description)

Overrides:

succeeded in class org.junit.rules.TestWatcher

skipped

protected void skipped(org.junit.AssumptionViolatedException e,
                       org.junit.runner.Description description)

Overrides:

skipped in class org.junit.rules.TestWatcher

failed

protected void failed(Throwable e,
                      org.junit.runner.Description description)

Overrides:

failed in class org.junit.rules.TestWatcher