net.serenitybdd.junit.runners

Class SerenityRunner

java.lang.Object

org.junit.runner.Runner

org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

org.junit.runners.BlockJUnit4ClassRunner

net.serenitybdd.junit.runners.SerenityRunner

All Implemented Interfaces:

org.junit.runner.Describable, org.junit.runner.manipulation.Filterable, org.junit.runner.manipulation.Sortable

Direct Known Subclasses:

ThucydidesRunner

public class SerenityRunner
extends org.junit.runners.BlockJUnit4ClassRunner

A test runner for WebDriver-based web tests. This test runner initializes a WebDriver instance before running the tests in their order of appearance. At the end of the tests, it closes and quits the WebDriver instance. The test runner will by default produce output in XML and HTML. This can extended by subscribing more reporter implementations to the test runner.

Constructor Summary

Constructors

Constructor and Description
SerenityRunner(java.lang.Class<?> klass) Creates a new test runner for WebDriver web tests.
SerenityRunner(java.lang.Class<?> klass, net.thucydides.core.batches.BatchManager batchManager)
SerenityRunner(java.lang.Class<?> klass, com.google.inject.Injector injector)
SerenityRunner(java.lang.Class<?> klass, com.google.inject.Module module) Creates a new test runner for WebDriver web tests.
SerenityRunner(java.lang.Class<?> klass, net.thucydides.core.webdriver.WebDriverFactory webDriverFactory)
SerenityRunner(java.lang.Class<?> klass, net.thucydides.core.webdriver.WebDriverFactory webDriverFactory, net.thucydides.core.webdriver.Configuration configuration)
SerenityRunner(java.lang.Class<?> klass, net.thucydides.core.webdriver.WebDriverFactory webDriverFactory, net.thucydides.core.webdriver.Configuration configuration, net.thucydides.core.batches.BatchManager batchManager)
SerenityRunner(java.lang.Class<?> klass, net.thucydides.core.webdriver.WebdriverManager webDriverManager, net.thucydides.core.webdriver.Configuration configuration, net.thucydides.core.batches.BatchManager batchManager)

Method Summary

Modifier and Type	Method and Description
java.io.File	getOutputDirectory()
net.thucydides.core.pages.Pages	getPages()
java.util.List<net.thucydides.core.model.TestOutcome>	getTestOutcomes() Find the current set of test outcomes produced by the test execution.
boolean	isAWebTest()
void	run(org.junit.runner.notification.RunNotifier notifier) Runs the tests in the acceptance test case.
void	subscribeReporter(net.thucydides.core.reports.AcceptanceTestReporter reporter) To generate reports, different AcceptanceTestReporter instances need to subscribe to the listener.
void	useQualifier(java.lang.String qualifier)

Methods inherited from class org.junit.runners.ParentRunner

filter, getDescription, getTestClass, setScheduler, sort

Methods inherited from class org.junit.runner.Runner

testCount

Methods inherited from class java.lang.Object

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

Constructor Detail

SerenityRunner

public SerenityRunner(java.lang.Class<?> klass)
               throws org.junit.runners.model.InitializationError

Creates a new test runner for WebDriver web tests.

Parameters:

klass - the class under test

Throws:

org.junit.runners.model.InitializationError - if some JUnit-related initialization problem occurred

SerenityRunner

public SerenityRunner(java.lang.Class<?> klass,
                      com.google.inject.Module module)
               throws org.junit.runners.model.InitializationError

Creates a new test runner for WebDriver web tests.

Parameters:

klass - the class under test

module - used to inject a custom Guice module

Throws:

org.junit.runners.model.InitializationError - if some JUnit-related initialization problem occurred

SerenityRunner

public SerenityRunner(java.lang.Class<?> klass,
                      com.google.inject.Injector injector)
               throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

SerenityRunner

public SerenityRunner(java.lang.Class<?> klass,
                      net.thucydides.core.webdriver.WebDriverFactory webDriverFactory)
               throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

SerenityRunner

public SerenityRunner(java.lang.Class<?> klass,
                      net.thucydides.core.webdriver.WebDriverFactory webDriverFactory,
                      net.thucydides.core.webdriver.Configuration configuration)
               throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

SerenityRunner

public SerenityRunner(java.lang.Class<?> klass,
                      net.thucydides.core.webdriver.WebDriverFactory webDriverFactory,
                      net.thucydides.core.webdriver.Configuration configuration,
                      net.thucydides.core.batches.BatchManager batchManager)
               throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

SerenityRunner

public SerenityRunner(java.lang.Class<?> klass,
                      net.thucydides.core.batches.BatchManager batchManager)
               throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

SerenityRunner

public SerenityRunner(java.lang.Class<?> klass,
                      net.thucydides.core.webdriver.WebdriverManager webDriverManager,
                      net.thucydides.core.webdriver.Configuration configuration,
                      net.thucydides.core.batches.BatchManager batchManager)
               throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

Method Detail

getPages

public net.thucydides.core.pages.Pages getPages()

getOutputDirectory

public java.io.File getOutputDirectory()

subscribeReporter

public void subscribeReporter(net.thucydides.core.reports.AcceptanceTestReporter reporter)

To generate reports, different AcceptanceTestReporter instances need to subscribe to the listener. The listener will tell them when the test is done, and the reporter can decide what to do.

Parameters:

reporter - an implementation of the AcceptanceTestReporter interface.

useQualifier

public void useQualifier(java.lang.String qualifier)

run

public void run(org.junit.runner.notification.RunNotifier notifier)

Runs the tests in the acceptance test case.

Overrides:

run in class org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

getTestOutcomes

public java.util.List<net.thucydides.core.model.TestOutcome> getTestOutcomes()

Find the current set of test outcomes produced by the test execution.

Returns:

the current list of test outcomes

isAWebTest

public boolean isAWebTest()