|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.openqa.selenium.support.events.EventFiringWebDriver
public class EventFiringWebDriver
A wrapper around an arbitrary WebDriver
instance
which supports registering of a WebDriverEventListener
,
e.g. for logging purposes.
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface org.openqa.selenium.WebDriver |
---|
WebDriver.ImeHandler, WebDriver.Navigation, WebDriver.Options, WebDriver.TargetLocator, WebDriver.Timeouts |
Constructor Summary | |
---|---|
EventFiringWebDriver(WebDriver driver)
|
Method Summary | ||
---|---|---|
void |
close()
Close the current window, quitting the browser if it's the last window currently open. |
|
Object |
executeAsyncScript(String script,
Object... args)
Execute an asynchronous piece of JavaScript in the context of the currently selected frame or window. |
|
Object |
executeScript(String script,
Object... args)
Executes JavaScript in the context of the currently selected frame or window. |
|
WebElement |
findElement(By by)
Find the first WebElement using the given method. |
|
List<WebElement> |
findElements(By by)
Find all elements within the current page using the given mechanism. |
|
void |
get(String url)
Load a new web page in the current browser window. |
|
String |
getCurrentUrl()
Get a string representing the current URL that the browser is looking at. |
|
Keyboard |
getKeyboard()
|
|
Mouse |
getMouse()
|
|
String |
getPageSource()
Get the source of the last loaded page. |
|
|
getScreenshotAs(OutputType<X> target)
Capture the screenshot and store it in the specified location. |
|
String |
getTitle()
The title of the current page. |
|
String |
getWindowHandle()
Return an opaque handle to this window that uniquely identifies it within this driver instance. |
|
Set<String> |
getWindowHandles()
Return a set of window handles which can be used to iterate over all open windows of this webdriver instance by passing them to #switchTo().window(String) |
|
WebDriver |
getWrappedDriver()
|
|
WebDriver.Options |
manage()
Gets the Option interface |
|
WebDriver.Navigation |
navigate()
An abstraction allowing the driver to access the browser's history and to navigate to a given URL. |
|
void |
quit()
Quits this driver, closing every associated window. |
|
EventFiringWebDriver |
register(WebDriverEventListener eventListener)
|
|
WebDriver.TargetLocator |
switchTo()
Send future commands to a different frame or window. |
|
EventFiringWebDriver |
unregister(WebDriverEventListener eventListener)
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public EventFiringWebDriver(WebDriver driver)
Method Detail |
---|
public EventFiringWebDriver register(WebDriverEventListener eventListener)
public EventFiringWebDriver unregister(WebDriverEventListener eventListener)
public WebDriver getWrappedDriver()
getWrappedDriver
in interface WrapsDriver
public void get(String url)
WebDriver
WebDriver.Navigation.to(String)
.
get
in interface WebDriver
url
- The URL to load. It is best to use a fully qualified URLpublic String getCurrentUrl()
WebDriver
getCurrentUrl
in interface WebDriver
public String getTitle()
WebDriver
getTitle
in interface WebDriver
public List<WebElement> findElements(By by)
WebDriver
findElements
in interface SearchContext
findElements
in interface WebDriver
by
- The locating mechanism to use
WebElement
s, or an empty list if nothing matchesBy
public WebElement findElement(By by)
WebDriver
WebElement
using the given method.
findElement
in interface SearchContext
findElement
in interface WebDriver
by
- The locating mechanism
public String getPageSource()
WebDriver
getPageSource
in interface WebDriver
public void close()
WebDriver
close
in interface WebDriver
public void quit()
WebDriver
quit
in interface WebDriver
public Set<String> getWindowHandles()
WebDriver
#switchTo().window(String)
getWindowHandles
in interface WebDriver
public String getWindowHandle()
WebDriver
getWindowHandle
in interface WebDriver
public Object executeScript(String script, Object... args)
JavascriptExecutor
Within the script, use document
to refer to the current
document. Note that local variables will not be available once the script
has finished executing, though global variables will persist.
If the script has a return value (i.e. if the script contains a
return
statement), then the following steps will be taken:
Arguments must be a number, a boolean, a String, WebElement, or a List of any combination of the above. An exception will be thrown if the arguments do not meet these criteria. The arguments will be made available to the JavaScript via the "arguments" magic variable, as if the function were called via "Function.apply"
executeScript
in interface JavascriptExecutor
script
- The JavaScript to executeargs
- The arguments to the script. May be empty
public Object executeAsyncScript(String script, Object... args)
JavascriptExecutor
synchronous JavaScript
, scripts
executed with this method must explicitly signal they are finished by
invoking the provided callback. This callback is always injected into the
executed function as the last argument.
The first argument passed to the callback function will be used as the script's result. This value will be handled as follows:
Example #1: Performing a sleep in the browser under test.
long start = System.currentTimeMillis();
((JavascriptExecutor) driver).executeAsyncScript(
"window.setTimeout(arguments[arguments.length - 1], 500);");
System.out.println(
"Elapsed time: " + System.currentTimeMillis() - start);
Example #2: Synchronizing a test with an AJAX application:
WebElement composeButton = driver.findElement(By.id("compose-button"));
composeButton.click();
((JavascriptExecutor) driver).executeAsyncScript(
"var callback = arguments[arguments.length - 1];" +
"mailClient.getComposeWindowWidget().onload(callback);");
driver.switchTo().frame("composeWidget");
driver.findElement(By.id("to")).sendKeys("bog@example.com");
Example #3: Injecting a XMLHttpRequest and waiting for the result:
Object response = ((JavascriptExecutor) driver).executeAsyncScript(
"var callback = arguments[arguments.length - 1];" +
"var xhr = new XMLHttpRequest();" +
"xhr.open('GET', '/resource/data.json', true);" +
"xhr.onreadystatechange = function() {" +
" if (xhr.readyState == 4) {" +
" callback(xhr.responseText);" +
" }" +
"}" +
"xhr.send();");
JSONObject json = new JSONObject((String) response);
assertEquals("cheese", json.getString("food"));
executeAsyncScript
in interface JavascriptExecutor
script
- The JavaScript to execute.args
- The arguments to the script. May be empty.
public <X> X getScreenshotAs(OutputType<X> target) throws WebDriverException
TakesScreenshot
getScreenshotAs
in interface TakesScreenshot
X
- Return type for getScreenshotAs.target
- target type, @see OutputType
WebDriverException
- on failure.public WebDriver.TargetLocator switchTo()
WebDriver
switchTo
in interface WebDriver
WebDriver.TargetLocator
public WebDriver.Navigation navigate()
WebDriver
navigate
in interface WebDriver
WebDriver.Navigation
that allows
the selection of what to do nextpublic WebDriver.Options manage()
WebDriver
manage
in interface WebDriver
WebDriver.Options
public Keyboard getKeyboard()
getKeyboard
in interface HasInputDevices
public Mouse getMouse()
getMouse
in interface HasInputDevices
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |