com.qmetry.qaf.automation.ui.webdriver

Class QAFExtendedWebDriver

java.lang.Object

org.openqa.selenium.remote.RemoteWebDriver

com.qmetry.qaf.automation.ui.webdriver.QAFExtendedWebDriver

All Implemented Interfaces:

QAFListener, UiDriver, FindsByCustomStretegy, QAFWebDriver, QAFWebDriverCommandListener, org.openqa.selenium.HasCapabilities, org.openqa.selenium.interactions.HasInputDevices, org.openqa.selenium.interactions.Interactive, org.openqa.selenium.internal.FindsByClassName, org.openqa.selenium.internal.FindsByCssSelector, org.openqa.selenium.internal.FindsById, org.openqa.selenium.internal.FindsByLinkText, org.openqa.selenium.internal.FindsByName, org.openqa.selenium.internal.FindsByTagName, org.openqa.selenium.internal.FindsByXPath, org.openqa.selenium.JavascriptExecutor, org.openqa.selenium.SearchContext, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WebDriver

Direct Known Subclasses:

LiveIsExtendedWebDriver

public class QAFExtendedWebDriver
extends org.openqa.selenium.remote.RemoteWebDriver
implements QAFWebDriver, QAFWebDriverCommandListener

com.qmetry.qaf.automation.ui.webdriver.QAFWebDriver.java

Author:

chirag

Nested Class Summary

Nested classes/interfaces inherited from class org.openqa.selenium.remote.RemoteWebDriver

org.openqa.selenium.remote.RemoteWebDriver.RemoteTargetLocator, org.openqa.selenium.remote.RemoteWebDriver.RemoteWebDriverOptions, org.openqa.selenium.remote.RemoteWebDriver.When

Nested classes/interfaces inherited from interface org.openqa.selenium.WebDriver

org.openqa.selenium.WebDriver.ImeHandler, org.openqa.selenium.WebDriver.Navigation, org.openqa.selenium.WebDriver.Options, org.openqa.selenium.WebDriver.TargetLocator, org.openqa.selenium.WebDriver.Timeouts, org.openqa.selenium.WebDriver.Window

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.commons.logging.Log	logger

Constructor Summary

Constructors

Constructor and Description
QAFExtendedWebDriver()
QAFExtendedWebDriver(org.openqa.selenium.remote.CommandExecutor cmdExecutor, org.openqa.selenium.Capabilities capabilities, WebDriverCommandLogger reporter)
QAFExtendedWebDriver(java.net.URL url, org.openqa.selenium.Capabilities capabilities)
QAFExtendedWebDriver(java.net.URL url, org.openqa.selenium.Capabilities capabilities, WebDriverCommandLogger reporter)
QAFExtendedWebDriver(org.openqa.selenium.WebDriver driver)
QAFExtendedWebDriver(org.openqa.selenium.WebDriver driver, WebDriverCommandLogger reporter)

Method Summary

Modifier and Type	Method and Description
void	afterCommand(QAFExtendedWebDriver driver, CommandTracker commandTracker)
void	assertCurrentUrl(StringMatcher text, long... timeout)
void	assertNoOfWindows(int count, long... timeout)
void	assertTitle(StringMatcher text, long... timeout)
void	beforeCommand(QAFExtendedWebDriver driver, CommandTracker commandTracker) This can be used as intercepter.
void	beforeInitialize(org.openqa.selenium.Capabilities desiredCapabilities) Here you can specify additional desired capabilities for the driver.
QAFExtendedWebElement	createElement(org.openqa.selenium.By by)
QAFExtendedWebElement	createElement(java.lang.String locator)
protected org.openqa.selenium.remote.Response	execute(org.openqa.selenium.remote.CommandPayload payload)
protected org.openqa.selenium.remote.Response	execute(java.lang.String driverCommand, java.util.Map<java.lang.String,?> parameters)
java.lang.Object	executeAsyncScript(java.lang.String script, java.lang.Object... args)
java.lang.Object	executeScript(java.lang.String script, java.lang.Object... args)
protected org.openqa.selenium.remote.Response	executeWitoutLog(java.lang.String driverCommand, java.util.Map<java.lang.String,?> parameters)
<T> T	extractScreenShot(org.openqa.selenium.WebDriverException e, org.openqa.selenium.OutputType<T> target)
QAFExtendedWebElement	findElement(org.openqa.selenium.By by)
QAFWebElement	findElement(java.lang.String locator)
QAFExtendedWebElement	findElementByCustomStretegy(java.lang.String stetegy, java.lang.String loc)
QAFExtendedWebElement	findElementBySizzleCss(java.lang.String using) Under evaluation only
java.util.List<QAFWebElement>	findElements(java.lang.String loc)
java.util.List<org.openqa.selenium.WebElement>	findElementsByCustomStretegy(java.lang.String stetegy, java.lang.String loc)
java.util.List<QAFExtendedWebElement>	findElementsBySizzleCss(java.lang.String using) Under evaluation only
org.openqa.selenium.Alert	getAlert()
org.openqa.selenium.Capabilities	getCapabilities()
<T> T	getCapabilityImpl() This method is useful to extract underlying driver specific interface implementation from the driver object.
java.util.List<QAFWebElement>	getElements(org.openqa.selenium.By by)
protected WebDriverCommandLogger	getReporter()
<X> X	getScreenshotAs(org.openqa.selenium.OutputType<X> target)
org.openqa.selenium.interactions.TouchScreen	getTouchScreen()
org.openqa.selenium.WebDriver	getUnderLayingDriver()
void	load(QAFExtendedWebElement... elements)
void	onFailure(QAFExtendedWebDriver driver, CommandTracker commandTracker) This can be used to propagate exception.
void	onInitializationFailure(org.openqa.selenium.Capabilities desiredCapabilities, java.lang.Throwable t)
void	onInitialize(QAFExtendedWebDriver driver) this method will be called when new driver instance is created
void	registerListeners(QAFWebDriverCommandListener listener)
protected void	report(java.lang.String op, boolean outcome, java.lang.Object... args)
void	setReporter(WebDriverCommandLogger reporter)
void	stop()
java.lang.String	takeScreenShot()
void	updateSessionId()
boolean	verifyCurrentUrl(StringMatcher text, long... timeout)
boolean	verifyNoOfWindows(int count, long... timeout)
boolean	verifyTitle(StringMatcher text, long... timeout)
void	waitForAjax(JsToolkit toolkit, long... timeout)
void	waitForAjax(long... timeout)
void	waitForAllElementPresent(QAFWebElement... elements)
void	waitForAllElementVisible(QAFWebElement... elements)
void	waitForAnyElementPresent(QAFWebElement... elements)
void	waitForAnyElementVisible(QAFWebElement... elements)
void	waitForCurrentUrl(StringMatcher matcher, long... timeout)
void	waitForNoOfWindows(int count, long... timeout)
void	waitForWindowTitle(StringMatcher titlematcher, long... timeout)

Methods inherited from class org.openqa.selenium.remote.RemoteWebDriver

close, execute, findElement, findElementByClassName, findElementByCssSelector, findElementById, findElementByLinkText, findElementByName, findElementByPartialLinkText, findElementByTagName, findElementByXPath, findElements, findElements, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByLinkText, findElementsByName, findElementsByPartialLinkText, findElementsByTagName, findElementsByXPath, get, getCommandExecutor, getCurrentUrl, getElementConverter, getErrorHandler, getExecuteMethod, getFileDetector, getKeyboard, getMouse, getPageSource, getSessionId, getTitle, getWindowHandle, getWindowHandles, log, manage, navigate, perform, quit, resetInputState, setCommandExecutor, setElementConverter, setErrorHandler, setFileDetector, setFoundBy, setLogLevel, setSessionId, startClient, startClient, startSession, stopClient, stopClient, switchTo, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.qmetry.qaf.automation.ui.webdriver.QAFWebDriver

getKeyboard, getMouse

Methods inherited from interface org.openqa.selenium.WebDriver

close, findElements, get, getCurrentUrl, getPageSource, getTitle, getWindowHandle, getWindowHandles, manage, navigate, quit, switchTo

Field Detail

logger

protected final org.apache.commons.logging.Log logger

Constructor Detail

QAFExtendedWebDriver

public QAFExtendedWebDriver(java.net.URL url,
                            org.openqa.selenium.Capabilities capabilities)

QAFExtendedWebDriver

public QAFExtendedWebDriver(org.openqa.selenium.WebDriver driver)

QAFExtendedWebDriver

public QAFExtendedWebDriver(java.net.URL url,
                            org.openqa.selenium.Capabilities capabilities,
                            WebDriverCommandLogger reporter)

QAFExtendedWebDriver

public QAFExtendedWebDriver(org.openqa.selenium.remote.CommandExecutor cmdExecutor,
                            org.openqa.selenium.Capabilities capabilities,
                            WebDriverCommandLogger reporter)

QAFExtendedWebDriver

public QAFExtendedWebDriver()

QAFExtendedWebDriver

public QAFExtendedWebDriver(org.openqa.selenium.WebDriver driver,
                            WebDriverCommandLogger reporter)

Method Detail

getCapabilities

public org.openqa.selenium.Capabilities getCapabilities()

Specified by:

getCapabilities in interface org.openqa.selenium.HasCapabilities

Overrides:

getCapabilities in class org.openqa.selenium.remote.RemoteWebDriver

getUnderLayingDriver

public org.openqa.selenium.WebDriver getUnderLayingDriver()

getReporter

protected WebDriverCommandLogger getReporter()

setReporter

public void setReporter(WebDriverCommandLogger reporter)

findElement

public QAFExtendedWebElement findElement(org.openqa.selenium.By by)

Specified by:

findElement in interface QAFWebDriver

Specified by:

findElement in interface org.openqa.selenium.SearchContext

Specified by:

findElement in interface org.openqa.selenium.WebDriver

Overrides:

findElement in class org.openqa.selenium.remote.RemoteWebDriver

findElement

public QAFWebElement findElement(java.lang.String locator)

Specified by:

findElement in interface QAFWebDriver

Parameters:

locator - - selenium 1 type locator for example "id=eleid", "name=eleName" etc...

Returns:

findElements

public java.util.List<QAFWebElement> findElements(java.lang.String loc)

Specified by:

findElements in interface QAFWebDriver

createElement

public QAFExtendedWebElement createElement(org.openqa.selenium.By by)

createElement

public QAFExtendedWebElement createElement(java.lang.String locator)

getElements

public java.util.List<QAFWebElement> getElements(org.openqa.selenium.By by)

Specified by:

getElements in interface QAFWebDriver

load

public void load(QAFExtendedWebElement... elements)

execute

protected org.openqa.selenium.remote.Response execute(org.openqa.selenium.remote.CommandPayload payload)

execute

protected org.openqa.selenium.remote.Response execute(java.lang.String driverCommand,
                                                      java.util.Map<java.lang.String,?> parameters)

Overrides:

execute in class org.openqa.selenium.remote.RemoteWebDriver

executeWitoutLog

protected org.openqa.selenium.remote.Response executeWitoutLog(java.lang.String driverCommand,
                                                               java.util.Map<java.lang.String,?> parameters)

getScreenshotAs

public <X> X getScreenshotAs(org.openqa.selenium.OutputType<X> target)
                      throws org.openqa.selenium.WebDriverException

Specified by:

getScreenshotAs in interface org.openqa.selenium.TakesScreenshot

Overrides:

getScreenshotAs in class org.openqa.selenium.remote.RemoteWebDriver

Throws:

org.openqa.selenium.WebDriverException

extractScreenShot

public <T> T extractScreenShot(org.openqa.selenium.WebDriverException e,
                               org.openqa.selenium.OutputType<T> target)

getAlert

public org.openqa.selenium.Alert getAlert()

afterCommand

public void afterCommand(QAFExtendedWebDriver driver,
                         CommandTracker commandTracker)

Specified by:

afterCommand in interface QAFWebDriverCommandListener

updateSessionId

public void updateSessionId()

beforeCommand

public void beforeCommand(QAFExtendedWebDriver driver,
                          CommandTracker commandTracker)

Description copied from interface: QAFWebDriverCommandListener

This can be used as intercepter. If you want to skip execution of actual command then set response in CommandTracker.setResponce(Response)

Specified by:

beforeCommand in interface QAFWebDriverCommandListener

onFailure

public void onFailure(QAFExtendedWebDriver driver,
                      CommandTracker commandTracker)

Description copied from interface: QAFWebDriverCommandListener

This can be used to propagate exception. You can get information about from where exception thrown by inspecting CommandTracker.getStage()

Specified by:

onFailure in interface QAFWebDriverCommandListener

onInitialize

public void onInitialize(QAFExtendedWebDriver driver)

Description copied from interface: QAFWebDriverCommandListener

this method will be called when new driver instance is created

Specified by:

onInitialize in interface QAFWebDriverCommandListener

onInitializationFailure

public void onInitializationFailure(org.openqa.selenium.Capabilities desiredCapabilities,
                                    java.lang.Throwable t)

Specified by:

onInitializationFailure in interface QAFWebDriverCommandListener

registerListeners

public void registerListeners(QAFWebDriverCommandListener listener)

findElementBySizzleCss

public QAFExtendedWebElement findElementBySizzleCss(java.lang.String using)

Under evaluation only

Parameters:

using -

Returns:

findElementsBySizzleCss

public java.util.List<QAFExtendedWebElement> findElementsBySizzleCss(java.lang.String using)

Under evaluation only

Parameters:

using -

Returns:

getTouchScreen

public org.openqa.selenium.interactions.TouchScreen getTouchScreen()

Specified by:

getTouchScreen in interface QAFWebDriver

takeScreenShot

public java.lang.String takeScreenShot()

Specified by:

takeScreenShot in interface UiDriver

waitForAjax

public void waitForAjax(JsToolkit toolkit,
                        long... timeout)

Specified by:

waitForAjax in interface QAFWebDriver

waitForAjax

public void waitForAjax(long... timeout)

Specified by:

waitForAjax in interface QAFWebDriver

waitForAnyElementPresent

public void waitForAnyElementPresent(QAFWebElement... elements)

Specified by:

waitForAnyElementPresent in interface QAFWebDriver

waitForAllElementPresent

public void waitForAllElementPresent(QAFWebElement... elements)

Specified by:

waitForAllElementPresent in interface QAFWebDriver

waitForAnyElementVisible

public void waitForAnyElementVisible(QAFWebElement... elements)

Specified by:

waitForAnyElementVisible in interface QAFWebDriver

waitForAllElementVisible

public void waitForAllElementVisible(QAFWebElement... elements)

Specified by:

waitForAllElementVisible in interface QAFWebDriver

waitForWindowTitle

public void waitForWindowTitle(StringMatcher titlematcher,
                               long... timeout)

Specified by:

waitForWindowTitle in interface QAFWebDriver

waitForCurrentUrl

public void waitForCurrentUrl(StringMatcher matcher,
                              long... timeout)

Specified by:

waitForCurrentUrl in interface QAFWebDriver

waitForNoOfWindows

public void waitForNoOfWindows(int count,
                               long... timeout)

Specified by:

waitForNoOfWindows in interface QAFWebDriver

verifyTitle

public boolean verifyTitle(StringMatcher text,
                           long... timeout)

Specified by:

verifyTitle in interface QAFWebDriver

verifyCurrentUrl

public boolean verifyCurrentUrl(StringMatcher text,
                                long... timeout)

Specified by:

verifyCurrentUrl in interface QAFWebDriver

verifyNoOfWindows

public boolean verifyNoOfWindows(int count,
                                 long... timeout)

Specified by:

verifyNoOfWindows in interface QAFWebDriver

assertTitle

public void assertTitle(StringMatcher text,
                        long... timeout)

Specified by:

assertTitle in interface QAFWebDriver

assertCurrentUrl

public void assertCurrentUrl(StringMatcher text,
                             long... timeout)

Specified by:

assertCurrentUrl in interface QAFWebDriver

assertNoOfWindows

public void assertNoOfWindows(int count,
                              long... timeout)

report

protected void report(java.lang.String op,
                      boolean outcome,
                      java.lang.Object... args)

beforeInitialize

public void beforeInitialize(org.openqa.selenium.Capabilities desiredCapabilities)

Description copied from interface: QAFWebDriverCommandListener

Here you can specify additional desired capabilities for the driver.

Specified by:

beforeInitialize in interface QAFWebDriverCommandListener

getCapabilityImpl

public <T> T getCapabilityImpl()

This method is useful to extract underlying driver specific interface implementation from the driver object. For Example, Assuming desired capability rotatable is true you can extract Rotatable interface from driver as below.
Rotatable rotatable = driver.getCapabilityImpl();
rotatable.rotate(ScreenOrientation.LANDSCAPE);

Returns:

findElementByCustomStretegy

public QAFExtendedWebElement findElementByCustomStretegy(java.lang.String stetegy,
                                                         java.lang.String loc)

Specified by:

findElementByCustomStretegy in interface FindsByCustomStretegy

findElementsByCustomStretegy

public java.util.List<org.openqa.selenium.WebElement> findElementsByCustomStretegy(java.lang.String stetegy,
                                                                                   java.lang.String loc)

Specified by:

findElementsByCustomStretegy in interface FindsByCustomStretegy

stop

public void stop()

Specified by:

stop in interface UiDriver

executeScript

public java.lang.Object executeScript(java.lang.String script,
                                      java.lang.Object... args)

Specified by:

executeScript in interface org.openqa.selenium.JavascriptExecutor

Overrides:

executeScript in class org.openqa.selenium.remote.RemoteWebDriver

executeAsyncScript

public java.lang.Object executeAsyncScript(java.lang.String script,
                                           java.lang.Object... args)

Specified by:

executeAsyncScript in interface org.openqa.selenium.JavascriptExecutor

Overrides:

executeAsyncScript in class org.openqa.selenium.remote.RemoteWebDriver