org.rnorth.testcontainers.junit

Class BrowserWebDriverContainerRule

java.lang.Object

org.junit.rules.TestWatcher

org.rnorth.testcontainers.junit.BrowserWebDriverContainerRule

All Implemented Interfaces:

org.junit.rules.TestRule

public class BrowserWebDriverContainerRule
extends org.junit.rules.TestWatcher

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BrowserWebDriverContainerRule.VncRecordingMode

Constructor Summary

Constructors

Constructor and Description
BrowserWebDriverContainerRule(org.openqa.selenium.remote.DesiredCapabilities desiredCapabilities)
BrowserWebDriverContainerRule(org.openqa.selenium.remote.DesiredCapabilities desiredCapabilities, BrowserWebDriverContainerRule.VncRecordingMode recordingMode, File vncRecordingDirectory)

Method Summary

Modifier and Type	Method and Description
protected void	failed(Throwable e, org.junit.runner.Description description)
protected void	finished(org.junit.runner.Description description)
String	getHostIpAddress() Get the IP address that containers (browsers) can use to reference a service running on the local machine, i.e.
URL	getSeleniumURL(org.openqa.selenium.remote.RemoteWebDriver driver)
String	getVncUrl(org.openqa.selenium.remote.RemoteWebDriver driver)
org.openqa.selenium.remote.RemoteWebDriver	newDriver() Obtain a new RemoteWebDriver instance that is bound to an instance of the browser running inside a new container.
protected void	succeeded(org.junit.runner.Description description)

Methods inherited from class org.junit.rules.TestWatcher

apply, skipped, skipped, starting

Methods inherited from class java.lang.Object

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

Constructor Detail

BrowserWebDriverContainerRule

public BrowserWebDriverContainerRule(org.openqa.selenium.remote.DesiredCapabilities desiredCapabilities)

BrowserWebDriverContainerRule

public BrowserWebDriverContainerRule(org.openqa.selenium.remote.DesiredCapabilities desiredCapabilities,
                                     BrowserWebDriverContainerRule.VncRecordingMode recordingMode,
                                     File vncRecordingDirectory)

Method Detail

newDriver

public org.openqa.selenium.remote.RemoteWebDriver newDriver()

Obtain a new RemoteWebDriver instance that is bound to an instance of the browser running inside a new container. All containers and drivers will be automatically shut down after the test method finishes (if used as a @Rule) or the test class (if used as a @ClassRule)

Returns:

a new Remote Web Driver instance

failed

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

Overrides:

failed in class org.junit.rules.TestWatcher

succeeded

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

Overrides:

succeeded in class org.junit.rules.TestWatcher

finished

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

Overrides:

finished in class org.junit.rules.TestWatcher

getHostIpAddress

public String getHostIpAddress()

Get the IP address that containers (browsers) can use to reference a service running on the local machine, i.e. the machine on which this test is running. For example, if a web server is running on port 8080 on this local machine, the containerized web driver needs to be pointed at "http://" + getHostIpAddress() + ":8080" in order to access it. Trying to hit localhost from inside the container is not going to work, since the container has its own IP address.

Returns:

the IP address of the host machine

getVncUrl

public String getVncUrl(org.openqa.selenium.remote.RemoteWebDriver driver)

getSeleniumURL

public URL getSeleniumURL(org.openqa.selenium.remote.RemoteWebDriver driver)