Package org.apache.tapestry5.test
Class SeleniumTestCase
- java.lang.Object
-
- org.testng.Assert
-
- org.apache.tapestry5.test.SeleniumTestCase
-
- All Implemented Interfaces:
com.thoughtworks.selenium.Selenium
public abstract class SeleniumTestCase extends org.testng.Assert implements com.thoughtworks.selenium.Selenium
Base class for creating Selenium-based integration test cases. This class implements all the methods ofSelenium
and delegates to an instance (setup once per test bytestStartup(org.testng.ITestContext, org.testng.xml.XmlTest)
.- Since:
- 5.2.0
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
JETTY_7
static org.slf4j.Logger
LOGGER
static java.lang.String
PAGE_LOAD_TIMEOUT
15 secondsprotected com.thoughtworks.selenium.Selenium
selenium
Deprecated.static java.lang.String
SUBMIT
An XPath expression for locating a submit element (very commonly used withclickAndWait(String)
.static java.lang.String
TOMCAT_6
protected org.openqa.selenium.WebDriver
webDriver
-
Constructor Summary
Constructors Constructor Description SeleniumTestCase()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
addCustomRequestHeader(java.lang.String key, java.lang.String value)
void
addLocationStrategy(java.lang.String strategyName, java.lang.String functionDefinition)
void
addScript(java.lang.String scriptContent, java.lang.String scriptTagId)
void
addSelection(java.lang.String locator, java.lang.String optionLocator)
void
allowNativeXpath(java.lang.String allow)
void
altKeyDown()
void
altKeyUp()
void
answerOnNextPrompt(java.lang.String answer)
protected void
assertAttribute(java.lang.String locator, java.lang.String expected)
Used when the locator identifies an attribute, not an element.protected void
assertFieldValue(java.lang.String locator, java.lang.String expected)
Assets that the value in the field matches the expectationprotected void
assertSourcePresent(java.lang.String... expected)
Assets that each string provided is present somewhere in the current document.protected void
assertText(java.lang.String locator, java.lang.String expected)
Asserts the text of an element, identified by the locator.protected void
assertTextNotPresent(java.lang.String... text)
protected void
assertTextPresent(java.lang.String... text)
protected void
assertTitle(java.lang.String expected)
Asserts that the current page's title matches the expected value.void
assignId(java.lang.String locator, java.lang.String identifier)
void
attachFile(java.lang.String fieldLocator, java.lang.String fileLocator)
void
captureEntirePageScreenshot(java.lang.String filename, java.lang.String kwargs)
java.lang.String
captureEntirePageScreenshotToString(java.lang.String kwargs)
java.lang.String
captureNetworkTraffic(java.lang.String type)
void
captureScreenshot(java.lang.String filename)
java.lang.String
captureScreenshotToString()
void
check(java.lang.String locator)
void
chooseCancelOnNextConfirmation()
void
chooseOkOnNextConfirmation()
void
cleanup()
void
cleanupTestMethod()
void
click(java.lang.String locator)
protected void
clickAndWait(java.lang.String locator)
Click a link identified by a locator, then wait for the resulting page to load.void
clickAt(java.lang.String locator, java.lang.String coordString)
void
close()
void
contextMenu(java.lang.String locator)
void
contextMenuAt(java.lang.String locator, java.lang.String coordString)
void
controlKeyDown()
void
controlKeyUp()
protected static org.openqa.selenium.By
convertLocator(java.lang.String locator)
void
createCookie(java.lang.String nameValuePair, java.lang.String optionsString)
void
deleteAllVisibleCookies()
void
deleteCookie(java.lang.String name, java.lang.String optionsString)
void
deselectPopUp()
void
doubleClick(java.lang.String locator)
void
doubleClickAt(java.lang.String locator, java.lang.String coordString)
void
dragAndDrop(java.lang.String locator, java.lang.String movementsString)
void
dragAndDropToObject(java.lang.String locatorOfObjectToBeDragged, java.lang.String locatorOfDragDestinationObject)
void
dragdrop(java.lang.String locator, java.lang.String movementsString)
void
fireEvent(java.lang.String locator, java.lang.String eventName)
void
focus(java.lang.String locator)
java.lang.String
getAlert()
java.lang.String[]
getAllButtons()
java.lang.String[]
getAllFields()
java.lang.String[]
getAllLinks()
java.lang.String[]
getAllWindowIds()
java.lang.String[]
getAllWindowNames()
java.lang.String[]
getAllWindowTitles()
java.lang.String
getAttribute(java.lang.String attributeLocator)
java.lang.String[]
getAttributeFromAllWindows(java.lang.String attributeName)
java.lang.String
getBaseURL()
Returns the base URL for the application.java.lang.String
getBodyText()
java.lang.String
getConfirmation()
java.lang.String
getCookie()
java.lang.String
getCookieByName(java.lang.String name)
java.lang.Number
getCssCount(java.lang.String str)
java.lang.Number
getCursorPosition(java.lang.String locator)
java.lang.Number
getElementHeight(java.lang.String locator)
java.lang.Number
getElementIndex(java.lang.String locator)
java.lang.Number
getElementPositionLeft(java.lang.String locator)
java.lang.Number
getElementPositionTop(java.lang.String locator)
java.lang.Number
getElementWidth(java.lang.String locator)
java.lang.String
getEval(java.lang.String script)
java.lang.String
getExpression(java.lang.String expression)
java.lang.String
getHtmlSource()
java.lang.String
getLocation()
java.lang.String
getLog()
java.lang.Number
getMouseSpeed()
java.lang.String
getPrompt()
java.lang.String
getSelectedId(java.lang.String selectLocator)
java.lang.String[]
getSelectedIds(java.lang.String selectLocator)
java.lang.String
getSelectedIndex(java.lang.String selectLocator)
java.lang.String[]
getSelectedIndexes(java.lang.String selectLocator)
java.lang.String
getSelectedLabel(java.lang.String selectLocator)
java.lang.String[]
getSelectedLabels(java.lang.String selectLocator)
java.lang.String
getSelectedValue(java.lang.String selectLocator)
java.lang.String[]
getSelectedValues(java.lang.String selectLocator)
java.lang.String[]
getSelectOptions(java.lang.String selectLocator)
java.lang.String
getSpeed()
java.lang.String
getTable(java.lang.String tableCellAddress)
java.lang.String
getText(java.lang.String locator)
java.lang.String
getTitle()
java.lang.String
getValue(java.lang.String locator)
boolean
getWhetherThisFrameMatchFrameExpression(java.lang.String currentFrameString, java.lang.String target)
boolean
getWhetherThisWindowMatchWindowExpression(java.lang.String currentWindowString, java.lang.String target)
java.lang.Number
getXpathCount(java.lang.String xpath)
void
goBack()
void
highlight(java.lang.String locator)
void
ignoreAttributesWithoutValue(java.lang.String ignore)
void
indicateTestMethodName(java.lang.reflect.Method testMethod)
boolean
isAlertPresent()
boolean
isChecked(java.lang.String locator)
boolean
isConfirmationPresent()
boolean
isCookiePresent(java.lang.String name)
boolean
isEditable(java.lang.String locator)
boolean
isElementPresent(java.lang.String locator)
boolean
isOrdered(java.lang.String locator1, java.lang.String locator2)
boolean
isPromptPresent()
boolean
isSomethingSelected(java.lang.String selectLocator)
boolean
isTextPresent(java.lang.String pattern)
boolean
isVisible(java.lang.String locator)
void
keyDown(java.lang.String locator, java.lang.String keySequence)
void
keyDownNative(java.lang.String keycode)
void
keyPress(java.lang.String locator, java.lang.String keySequence)
void
keyPressNative(java.lang.String keycode)
void
keyUp(java.lang.String locator, java.lang.String keySequence)
void
keyUpNative(java.lang.String keycode)
protected java.lang.Runnable
launchWebServer(java.lang.String container, java.lang.String webAppFolder, java.lang.String contextPath, int port, int sslPort)
Invoked fromtestStartup(org.testng.ITestContext, org.testng.xml.XmlTest)
to launch the web server to be tested.void
metaKeyDown()
void
metaKeyUp()
void
mouseDown(java.lang.String locator)
void
mouseDownAt(java.lang.String locator, java.lang.String coordString)
void
mouseDownRight(java.lang.String locator)
void
mouseDownRightAt(java.lang.String locator, java.lang.String coordString)
void
mouseMove(java.lang.String locator)
void
mouseMoveAt(java.lang.String locator, java.lang.String coordString)
void
mouseOut(java.lang.String locator)
void
mouseOver(java.lang.String locator)
void
mouseUp(java.lang.String locator)
void
mouseUpAt(java.lang.String locator, java.lang.String coordString)
void
mouseUpRight(java.lang.String locator)
void
mouseUpRightAt(java.lang.String locator, java.lang.String coordString)
void
open(java.lang.String url)
void
open(java.lang.String url, java.lang.String ignoreResponseCode)
protected void
openBaseURL()
Open the getBaseURL(), and waits for the page to load.protected void
openLinks(java.lang.String... linkText)
Opens the base URL, then clicks through a series of links to get to a desired application state.void
openWindow(java.lang.String url, java.lang.String windowID)
void
refresh()
void
removeAllSelections(java.lang.String locator)
void
removeScript(java.lang.String scriptTagId)
void
removeSelection(java.lang.String locator, java.lang.String optionLocator)
protected void
reportAndThrowAssertionError(java.lang.String message, java.lang.Object... arguments)
Formats a message from the provided arguments, which is written to System.err.java.lang.String
retrieveLastRemoteControlLogs()
void
rollup(java.lang.String rollupName, java.lang.String kwargs)
void
runScript(java.lang.String script)
void
scrollIntoView(org.openqa.selenium.WebElement element)
void
select(java.lang.String selectLocator, java.lang.String optionLocator)
void
selectFrame(java.lang.String locator)
void
selectPopUp(java.lang.String windowID)
void
selectWindow(java.lang.String windowID)
void
setBrowserLogLevel(java.lang.String logLevel)
void
setContext(java.lang.String context)
void
setCursorPosition(java.lang.String locator, java.lang.String position)
void
setExtensionJs(java.lang.String extensionJs)
void
setMouseSpeed(java.lang.String pixels)
void
setSpeed(java.lang.String value)
void
setTimeout(java.lang.String timeout)
void
setup(org.testng.ITestContext context)
void
shiftKeyDown()
void
shiftKeyUp()
void
showContextualBanner()
void
showContextualBanner(java.lang.String className, java.lang.String methodName)
void
shutDownSeleniumServer()
protected void
sleep(long millis)
Sleeps for the indicated number of seconds.void
start()
void
start(java.lang.Object optionsObject)
void
start(java.lang.String optionsString)
void
stop()
void
submit(java.lang.String formLocator)
void
testShutdown(org.testng.ITestContext context)
LiketestStartup(org.testng.ITestContext, org.testng.xml.XmlTest)
, this may be called multiple times against multiple instances, but only does work the first time.void
testStartup(org.testng.ITestContext testContext, org.testng.xml.XmlTest xmlTest)
Starts up the servers for the entire test (i.e., for multiple TestCases).void
type(java.lang.String locator, java.lang.String value)
void
typeKeys(java.lang.String locator, java.lang.String value)
void
uncheck(java.lang.String locator)
protected void
unreachable()
void
useXpathLibrary(java.lang.String libraryName)
protected void
waitForAjaxRequestsToComplete()
Waits until all active XHR requests (as noted by the t5/core/dom module) have completed.protected void
waitForAjaxRequestsToComplete(java.lang.String timeout)
Deprecated.Deprecated in 5.4 in favor of the version without a timeoutvoid
waitForCondition(java.lang.String script, java.lang.String timeout)
protected void
waitForCondition(org.openqa.selenium.support.ui.ExpectedCondition condition)
protected void
waitForCondition(org.openqa.selenium.support.ui.ExpectedCondition condition, long timeoutSeconds)
protected void
waitForCssSelectorToAppear(java.lang.String selector)
Waits for an element with a given CSS selector to appear.protected void
waitForElementToAppear(java.lang.String elementId)
Waits for the element with the given client-side id to be present in the DOM ( does not assure that the element is visible).protected void
waitForElementToDisappear(java.lang.String elementId)
Deprecated.Deprecated in 5.4 with no replacementvoid
waitForFrameToLoad(java.lang.String frameAddress, java.lang.String timeout)
protected void
waitForInvisible(java.lang.String selector)
Waits for the element specified by the selector to become invisible Note that waitForElementToDisappear waits for the element to be absent from the dom, visible or not.protected void
waitForPageToLoad()
Waits for the page to load (up to 15 seconds).void
waitForPageToLoad(java.lang.String timeout)
Waits for page to load, then waits for initialization to finish, which is recognized by thedata-page-initialized
attribute being set to true on the body element.void
waitForPopUp(java.lang.String windowID, java.lang.String timeout)
protected void
waitForVisible(java.lang.String selector)
Waits for the element specified by the selector to become visible Note that waitForElementToAppear waits for the element to be present in the dom, visible or not.void
windowFocus()
void
windowMaximize()
protected void
writeErrorReport(java.lang.String reportText)
Delegates toErrorReporter.writeErrorReport(String)
to capture the current page markup in a file for later analysis.-
Methods inherited from class org.testng.Assert
assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEqualsDeep, assertEqualsDeep, assertEqualsDeep, assertEqualsNoOrder, assertEqualsNoOrder, assertFalse, assertFalse, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEquals, assertNotEqualsDeep, assertNotEqualsDeep, assertNotEqualsDeep, assertNotEqualsDeep, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertThrows, assertThrows, assertTrue, assertTrue, expectThrows, fail, fail, fail
-
-
-
-
Field Detail
-
LOGGER
public static final org.slf4j.Logger LOGGER
-
PAGE_LOAD_TIMEOUT
public static final java.lang.String PAGE_LOAD_TIMEOUT
15 seconds- See Also:
- Constant Field Values
-
TOMCAT_6
public static final java.lang.String TOMCAT_6
- See Also:
- Constant Field Values
-
JETTY_7
public static final java.lang.String JETTY_7
- See Also:
- Constant Field Values
-
SUBMIT
public static final java.lang.String SUBMIT
An XPath expression for locating a submit element (very commonly used withclickAndWait(String)
.- Since:
- 5.3
- See Also:
- Constant Field Values
-
selenium
@Deprecated protected com.thoughtworks.selenium.Selenium selenium
Deprecated.The underlyingSelenium
instance that all the methods of this class delegate to; this can be useful when attempting to use SeleniumTestCase with a newer version of Selenium which has added some methods to the interface. This field will not be set until the test case instance has gone through its full initialization.- Since:
- 5.3
-
webDriver
protected org.openqa.selenium.WebDriver webDriver
-
-
Constructor Detail
-
SeleniumTestCase
public SeleniumTestCase()
-
-
Method Detail
-
testStartup
@BeforeTest(dependsOnGroups="beforeStartup") public void testStartup(org.testng.ITestContext testContext, org.testng.xml.XmlTest xmlTest) throws java.lang.Exception
Starts up the servers for the entire test (i.e., for multiple TestCases). By placing <parameter> elements inside the appropriate <test> (of your testng.xml configuration file), you can change the configuration or behavior of the servers. It is common to have two or more identical tests that differ only in terms of thetapestry.browser-start-command
parameter, to run tests against multiple browsers.Parameter Name Default Description container tapestry.servlet-container JETTY_7 The Servlet container to use for the tests. Currently JETTY_7
orTOMCAT_6
webAppFolder tapestry.web-app-folder src/main/webapp Location of web application context contextPath tapestry.context-path empty string Context path (defaults to root). As elsewhere, the context path should be blank, or start with a slash (but not end with one). port tapestry.port 9090 Port number for web server to listen to sslPort tapestry.ssl-port 8443 Port number for web server to listen to for secure requests browserStartCommand tapestry.browser-start-command *firefox Command string used to launch the browser, as defined by Selenium Options and defaults ITestContext
to see if the necessary keys are already present).- Parameters:
testContext
- Used to share objects between the launcher and the test suites- Throws:
java.lang.Exception
-
testShutdown
@AfterTest public void testShutdown(org.testng.ITestContext context)
LiketestStartup(org.testng.ITestContext, org.testng.xml.XmlTest)
, this may be called multiple times against multiple instances, but only does work the first time.
-
launchWebServer
protected java.lang.Runnable launchWebServer(java.lang.String container, java.lang.String webAppFolder, java.lang.String contextPath, int port, int sslPort) throws java.lang.Exception
Invoked fromtestStartup(org.testng.ITestContext, org.testng.xml.XmlTest)
to launch the web server to be tested. The return value is a Runnable that can be invoked later to cleanly shut down the launched server at the end of the test.- Parameters:
container
- identifies which web server should be launchedwebAppFolder
- path to the web application contextcontextPath
- the path the context is mapped to, usually the empty stringport
- the port number the server should handlesslPort
- the port number on which the server should handle secure requests- Returns:
- Runnable used to shut down the server
- Throws:
java.lang.Exception
-
setup
@BeforeClass public void setup(org.testng.ITestContext context)
-
cleanup
@AfterClass public void cleanup()
-
writeErrorReport
protected void writeErrorReport(java.lang.String reportText)
Delegates toErrorReporter.writeErrorReport(String)
to capture the current page markup in a file for later analysis.
-
getBaseURL
public java.lang.String getBaseURL()
Returns the base URL for the application. This is of the typicallyhttp://localhost:9999/
(i.e., it includes a trailing slash). Generally, you should useopenLinks(String...)
to start from your application's home page.
-
indicateTestMethodName
@BeforeMethod public void indicateTestMethodName(java.lang.reflect.Method testMethod)
-
cleanupTestMethod
@AfterMethod public void cleanupTestMethod()
-
addCustomRequestHeader
public void addCustomRequestHeader(java.lang.String key, java.lang.String value)
- Specified by:
addCustomRequestHeader
in interfacecom.thoughtworks.selenium.Selenium
-
addLocationStrategy
public void addLocationStrategy(java.lang.String strategyName, java.lang.String functionDefinition)
- Specified by:
addLocationStrategy
in interfacecom.thoughtworks.selenium.Selenium
-
addScript
public void addScript(java.lang.String scriptContent, java.lang.String scriptTagId)
- Specified by:
addScript
in interfacecom.thoughtworks.selenium.Selenium
-
addSelection
public void addSelection(java.lang.String locator, java.lang.String optionLocator)
- Specified by:
addSelection
in interfacecom.thoughtworks.selenium.Selenium
-
allowNativeXpath
public void allowNativeXpath(java.lang.String allow)
- Specified by:
allowNativeXpath
in interfacecom.thoughtworks.selenium.Selenium
-
altKeyDown
public void altKeyDown()
- Specified by:
altKeyDown
in interfacecom.thoughtworks.selenium.Selenium
-
altKeyUp
public void altKeyUp()
- Specified by:
altKeyUp
in interfacecom.thoughtworks.selenium.Selenium
-
answerOnNextPrompt
public void answerOnNextPrompt(java.lang.String answer)
- Specified by:
answerOnNextPrompt
in interfacecom.thoughtworks.selenium.Selenium
-
assignId
public void assignId(java.lang.String locator, java.lang.String identifier)
- Specified by:
assignId
in interfacecom.thoughtworks.selenium.Selenium
-
attachFile
public void attachFile(java.lang.String fieldLocator, java.lang.String fileLocator)
- Specified by:
attachFile
in interfacecom.thoughtworks.selenium.Selenium
-
captureEntirePageScreenshot
public void captureEntirePageScreenshot(java.lang.String filename, java.lang.String kwargs)
- Specified by:
captureEntirePageScreenshot
in interfacecom.thoughtworks.selenium.Selenium
-
captureEntirePageScreenshotToString
public java.lang.String captureEntirePageScreenshotToString(java.lang.String kwargs)
- Specified by:
captureEntirePageScreenshotToString
in interfacecom.thoughtworks.selenium.Selenium
-
captureNetworkTraffic
public java.lang.String captureNetworkTraffic(java.lang.String type)
- Specified by:
captureNetworkTraffic
in interfacecom.thoughtworks.selenium.Selenium
-
captureScreenshot
public void captureScreenshot(java.lang.String filename)
- Specified by:
captureScreenshot
in interfacecom.thoughtworks.selenium.Selenium
-
captureScreenshotToString
public java.lang.String captureScreenshotToString()
- Specified by:
captureScreenshotToString
in interfacecom.thoughtworks.selenium.Selenium
-
check
public void check(java.lang.String locator)
- Specified by:
check
in interfacecom.thoughtworks.selenium.Selenium
-
chooseCancelOnNextConfirmation
public void chooseCancelOnNextConfirmation()
- Specified by:
chooseCancelOnNextConfirmation
in interfacecom.thoughtworks.selenium.Selenium
-
chooseOkOnNextConfirmation
public void chooseOkOnNextConfirmation()
- Specified by:
chooseOkOnNextConfirmation
in interfacecom.thoughtworks.selenium.Selenium
-
click
public void click(java.lang.String locator)
- Specified by:
click
in interfacecom.thoughtworks.selenium.Selenium
-
clickAt
public void clickAt(java.lang.String locator, java.lang.String coordString)
- Specified by:
clickAt
in interfacecom.thoughtworks.selenium.Selenium
-
close
public void close()
- Specified by:
close
in interfacecom.thoughtworks.selenium.Selenium
-
contextMenu
public void contextMenu(java.lang.String locator)
- Specified by:
contextMenu
in interfacecom.thoughtworks.selenium.Selenium
-
contextMenuAt
public void contextMenuAt(java.lang.String locator, java.lang.String coordString)
- Specified by:
contextMenuAt
in interfacecom.thoughtworks.selenium.Selenium
-
controlKeyDown
public void controlKeyDown()
- Specified by:
controlKeyDown
in interfacecom.thoughtworks.selenium.Selenium
-
controlKeyUp
public void controlKeyUp()
- Specified by:
controlKeyUp
in interfacecom.thoughtworks.selenium.Selenium
-
createCookie
public void createCookie(java.lang.String nameValuePair, java.lang.String optionsString)
- Specified by:
createCookie
in interfacecom.thoughtworks.selenium.Selenium
-
deleteAllVisibleCookies
public void deleteAllVisibleCookies()
- Specified by:
deleteAllVisibleCookies
in interfacecom.thoughtworks.selenium.Selenium
-
deleteCookie
public void deleteCookie(java.lang.String name, java.lang.String optionsString)
- Specified by:
deleteCookie
in interfacecom.thoughtworks.selenium.Selenium
-
deselectPopUp
public void deselectPopUp()
- Specified by:
deselectPopUp
in interfacecom.thoughtworks.selenium.Selenium
-
doubleClick
public void doubleClick(java.lang.String locator)
- Specified by:
doubleClick
in interfacecom.thoughtworks.selenium.Selenium
-
doubleClickAt
public void doubleClickAt(java.lang.String locator, java.lang.String coordString)
- Specified by:
doubleClickAt
in interfacecom.thoughtworks.selenium.Selenium
-
dragAndDrop
public void dragAndDrop(java.lang.String locator, java.lang.String movementsString)
- Specified by:
dragAndDrop
in interfacecom.thoughtworks.selenium.Selenium
-
dragAndDropToObject
public void dragAndDropToObject(java.lang.String locatorOfObjectToBeDragged, java.lang.String locatorOfDragDestinationObject)
- Specified by:
dragAndDropToObject
in interfacecom.thoughtworks.selenium.Selenium
-
dragdrop
public void dragdrop(java.lang.String locator, java.lang.String movementsString)
- Specified by:
dragdrop
in interfacecom.thoughtworks.selenium.Selenium
-
fireEvent
public void fireEvent(java.lang.String locator, java.lang.String eventName)
- Specified by:
fireEvent
in interfacecom.thoughtworks.selenium.Selenium
-
focus
public void focus(java.lang.String locator)
- Specified by:
focus
in interfacecom.thoughtworks.selenium.Selenium
-
getAlert
public java.lang.String getAlert()
- Specified by:
getAlert
in interfacecom.thoughtworks.selenium.Selenium
-
getAllButtons
public java.lang.String[] getAllButtons()
- Specified by:
getAllButtons
in interfacecom.thoughtworks.selenium.Selenium
-
getAllFields
public java.lang.String[] getAllFields()
- Specified by:
getAllFields
in interfacecom.thoughtworks.selenium.Selenium
-
getAllLinks
public java.lang.String[] getAllLinks()
- Specified by:
getAllLinks
in interfacecom.thoughtworks.selenium.Selenium
-
getAllWindowIds
public java.lang.String[] getAllWindowIds()
- Specified by:
getAllWindowIds
in interfacecom.thoughtworks.selenium.Selenium
-
getAllWindowNames
public java.lang.String[] getAllWindowNames()
- Specified by:
getAllWindowNames
in interfacecom.thoughtworks.selenium.Selenium
-
getAllWindowTitles
public java.lang.String[] getAllWindowTitles()
- Specified by:
getAllWindowTitles
in interfacecom.thoughtworks.selenium.Selenium
-
getAttribute
public java.lang.String getAttribute(java.lang.String attributeLocator)
- Specified by:
getAttribute
in interfacecom.thoughtworks.selenium.Selenium
-
getAttributeFromAllWindows
public java.lang.String[] getAttributeFromAllWindows(java.lang.String attributeName)
- Specified by:
getAttributeFromAllWindows
in interfacecom.thoughtworks.selenium.Selenium
-
getBodyText
public java.lang.String getBodyText()
- Specified by:
getBodyText
in interfacecom.thoughtworks.selenium.Selenium
-
getConfirmation
public java.lang.String getConfirmation()
- Specified by:
getConfirmation
in interfacecom.thoughtworks.selenium.Selenium
-
getCookie
public java.lang.String getCookie()
- Specified by:
getCookie
in interfacecom.thoughtworks.selenium.Selenium
-
getCookieByName
public java.lang.String getCookieByName(java.lang.String name)
- Specified by:
getCookieByName
in interfacecom.thoughtworks.selenium.Selenium
-
getCursorPosition
public java.lang.Number getCursorPosition(java.lang.String locator)
- Specified by:
getCursorPosition
in interfacecom.thoughtworks.selenium.Selenium
-
getElementHeight
public java.lang.Number getElementHeight(java.lang.String locator)
- Specified by:
getElementHeight
in interfacecom.thoughtworks.selenium.Selenium
-
getElementIndex
public java.lang.Number getElementIndex(java.lang.String locator)
- Specified by:
getElementIndex
in interfacecom.thoughtworks.selenium.Selenium
-
getElementPositionLeft
public java.lang.Number getElementPositionLeft(java.lang.String locator)
- Specified by:
getElementPositionLeft
in interfacecom.thoughtworks.selenium.Selenium
-
getElementPositionTop
public java.lang.Number getElementPositionTop(java.lang.String locator)
- Specified by:
getElementPositionTop
in interfacecom.thoughtworks.selenium.Selenium
-
getElementWidth
public java.lang.Number getElementWidth(java.lang.String locator)
- Specified by:
getElementWidth
in interfacecom.thoughtworks.selenium.Selenium
-
getEval
public java.lang.String getEval(java.lang.String script)
- Specified by:
getEval
in interfacecom.thoughtworks.selenium.Selenium
-
getExpression
public java.lang.String getExpression(java.lang.String expression)
- Specified by:
getExpression
in interfacecom.thoughtworks.selenium.Selenium
-
getHtmlSource
public java.lang.String getHtmlSource()
- Specified by:
getHtmlSource
in interfacecom.thoughtworks.selenium.Selenium
-
getLocation
public java.lang.String getLocation()
- Specified by:
getLocation
in interfacecom.thoughtworks.selenium.Selenium
-
getLog
public java.lang.String getLog()
- Specified by:
getLog
in interfacecom.thoughtworks.selenium.Selenium
-
getMouseSpeed
public java.lang.Number getMouseSpeed()
- Specified by:
getMouseSpeed
in interfacecom.thoughtworks.selenium.Selenium
-
getPrompt
public java.lang.String getPrompt()
- Specified by:
getPrompt
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectedId
public java.lang.String getSelectedId(java.lang.String selectLocator)
- Specified by:
getSelectedId
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectedIds
public java.lang.String[] getSelectedIds(java.lang.String selectLocator)
- Specified by:
getSelectedIds
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectedIndex
public java.lang.String getSelectedIndex(java.lang.String selectLocator)
- Specified by:
getSelectedIndex
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectedIndexes
public java.lang.String[] getSelectedIndexes(java.lang.String selectLocator)
- Specified by:
getSelectedIndexes
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectedLabel
public java.lang.String getSelectedLabel(java.lang.String selectLocator)
- Specified by:
getSelectedLabel
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectedLabels
public java.lang.String[] getSelectedLabels(java.lang.String selectLocator)
- Specified by:
getSelectedLabels
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectedValue
public java.lang.String getSelectedValue(java.lang.String selectLocator)
- Specified by:
getSelectedValue
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectedValues
public java.lang.String[] getSelectedValues(java.lang.String selectLocator)
- Specified by:
getSelectedValues
in interfacecom.thoughtworks.selenium.Selenium
-
getSelectOptions
public java.lang.String[] getSelectOptions(java.lang.String selectLocator)
- Specified by:
getSelectOptions
in interfacecom.thoughtworks.selenium.Selenium
-
getSpeed
public java.lang.String getSpeed()
- Specified by:
getSpeed
in interfacecom.thoughtworks.selenium.Selenium
-
getTable
public java.lang.String getTable(java.lang.String tableCellAddress)
- Specified by:
getTable
in interfacecom.thoughtworks.selenium.Selenium
-
getText
public java.lang.String getText(java.lang.String locator)
- Specified by:
getText
in interfacecom.thoughtworks.selenium.Selenium
-
getTitle
public java.lang.String getTitle()
- Specified by:
getTitle
in interfacecom.thoughtworks.selenium.Selenium
-
getValue
public java.lang.String getValue(java.lang.String locator)
- Specified by:
getValue
in interfacecom.thoughtworks.selenium.Selenium
-
getWhetherThisFrameMatchFrameExpression
public boolean getWhetherThisFrameMatchFrameExpression(java.lang.String currentFrameString, java.lang.String target)
- Specified by:
getWhetherThisFrameMatchFrameExpression
in interfacecom.thoughtworks.selenium.Selenium
-
getWhetherThisWindowMatchWindowExpression
public boolean getWhetherThisWindowMatchWindowExpression(java.lang.String currentWindowString, java.lang.String target)
- Specified by:
getWhetherThisWindowMatchWindowExpression
in interfacecom.thoughtworks.selenium.Selenium
-
getXpathCount
public java.lang.Number getXpathCount(java.lang.String xpath)
- Specified by:
getXpathCount
in interfacecom.thoughtworks.selenium.Selenium
-
goBack
public void goBack()
- Specified by:
goBack
in interfacecom.thoughtworks.selenium.Selenium
-
highlight
public void highlight(java.lang.String locator)
- Specified by:
highlight
in interfacecom.thoughtworks.selenium.Selenium
-
ignoreAttributesWithoutValue
public void ignoreAttributesWithoutValue(java.lang.String ignore)
- Specified by:
ignoreAttributesWithoutValue
in interfacecom.thoughtworks.selenium.Selenium
-
isAlertPresent
public boolean isAlertPresent()
- Specified by:
isAlertPresent
in interfacecom.thoughtworks.selenium.Selenium
-
isChecked
public boolean isChecked(java.lang.String locator)
- Specified by:
isChecked
in interfacecom.thoughtworks.selenium.Selenium
-
isConfirmationPresent
public boolean isConfirmationPresent()
- Specified by:
isConfirmationPresent
in interfacecom.thoughtworks.selenium.Selenium
-
isCookiePresent
public boolean isCookiePresent(java.lang.String name)
- Specified by:
isCookiePresent
in interfacecom.thoughtworks.selenium.Selenium
-
isEditable
public boolean isEditable(java.lang.String locator)
- Specified by:
isEditable
in interfacecom.thoughtworks.selenium.Selenium
-
isElementPresent
public boolean isElementPresent(java.lang.String locator)
- Specified by:
isElementPresent
in interfacecom.thoughtworks.selenium.Selenium
-
isOrdered
public boolean isOrdered(java.lang.String locator1, java.lang.String locator2)
- Specified by:
isOrdered
in interfacecom.thoughtworks.selenium.Selenium
-
isPromptPresent
public boolean isPromptPresent()
- Specified by:
isPromptPresent
in interfacecom.thoughtworks.selenium.Selenium
-
isSomethingSelected
public boolean isSomethingSelected(java.lang.String selectLocator)
- Specified by:
isSomethingSelected
in interfacecom.thoughtworks.selenium.Selenium
-
isTextPresent
public boolean isTextPresent(java.lang.String pattern)
- Specified by:
isTextPresent
in interfacecom.thoughtworks.selenium.Selenium
-
isVisible
public boolean isVisible(java.lang.String locator)
- Specified by:
isVisible
in interfacecom.thoughtworks.selenium.Selenium
-
keyDown
public void keyDown(java.lang.String locator, java.lang.String keySequence)
- Specified by:
keyDown
in interfacecom.thoughtworks.selenium.Selenium
-
keyDownNative
public void keyDownNative(java.lang.String keycode)
- Specified by:
keyDownNative
in interfacecom.thoughtworks.selenium.Selenium
-
keyPress
public void keyPress(java.lang.String locator, java.lang.String keySequence)
- Specified by:
keyPress
in interfacecom.thoughtworks.selenium.Selenium
-
keyPressNative
public void keyPressNative(java.lang.String keycode)
- Specified by:
keyPressNative
in interfacecom.thoughtworks.selenium.Selenium
-
keyUp
public void keyUp(java.lang.String locator, java.lang.String keySequence)
- Specified by:
keyUp
in interfacecom.thoughtworks.selenium.Selenium
-
keyUpNative
public void keyUpNative(java.lang.String keycode)
- Specified by:
keyUpNative
in interfacecom.thoughtworks.selenium.Selenium
-
metaKeyDown
public void metaKeyDown()
- Specified by:
metaKeyDown
in interfacecom.thoughtworks.selenium.Selenium
-
metaKeyUp
public void metaKeyUp()
- Specified by:
metaKeyUp
in interfacecom.thoughtworks.selenium.Selenium
-
mouseDown
public void mouseDown(java.lang.String locator)
- Specified by:
mouseDown
in interfacecom.thoughtworks.selenium.Selenium
-
mouseDownAt
public void mouseDownAt(java.lang.String locator, java.lang.String coordString)
- Specified by:
mouseDownAt
in interfacecom.thoughtworks.selenium.Selenium
-
mouseDownRight
public void mouseDownRight(java.lang.String locator)
- Specified by:
mouseDownRight
in interfacecom.thoughtworks.selenium.Selenium
-
mouseDownRightAt
public void mouseDownRightAt(java.lang.String locator, java.lang.String coordString)
- Specified by:
mouseDownRightAt
in interfacecom.thoughtworks.selenium.Selenium
-
mouseMove
public void mouseMove(java.lang.String locator)
- Specified by:
mouseMove
in interfacecom.thoughtworks.selenium.Selenium
-
mouseMoveAt
public void mouseMoveAt(java.lang.String locator, java.lang.String coordString)
- Specified by:
mouseMoveAt
in interfacecom.thoughtworks.selenium.Selenium
-
mouseOut
public void mouseOut(java.lang.String locator)
- Specified by:
mouseOut
in interfacecom.thoughtworks.selenium.Selenium
-
mouseOver
public void mouseOver(java.lang.String locator)
- Specified by:
mouseOver
in interfacecom.thoughtworks.selenium.Selenium
-
mouseUp
public void mouseUp(java.lang.String locator)
- Specified by:
mouseUp
in interfacecom.thoughtworks.selenium.Selenium
-
mouseUpAt
public void mouseUpAt(java.lang.String locator, java.lang.String coordString)
- Specified by:
mouseUpAt
in interfacecom.thoughtworks.selenium.Selenium
-
mouseUpRight
public void mouseUpRight(java.lang.String locator)
- Specified by:
mouseUpRight
in interfacecom.thoughtworks.selenium.Selenium
-
mouseUpRightAt
public void mouseUpRightAt(java.lang.String locator, java.lang.String coordString)
- Specified by:
mouseUpRightAt
in interfacecom.thoughtworks.selenium.Selenium
-
open
public void open(java.lang.String url)
- Specified by:
open
in interfacecom.thoughtworks.selenium.Selenium
-
open
public void open(java.lang.String url, java.lang.String ignoreResponseCode)
- Specified by:
open
in interfacecom.thoughtworks.selenium.Selenium
-
openWindow
public void openWindow(java.lang.String url, java.lang.String windowID)
- Specified by:
openWindow
in interfacecom.thoughtworks.selenium.Selenium
-
refresh
public void refresh()
- Specified by:
refresh
in interfacecom.thoughtworks.selenium.Selenium
-
removeAllSelections
public void removeAllSelections(java.lang.String locator)
- Specified by:
removeAllSelections
in interfacecom.thoughtworks.selenium.Selenium
-
removeScript
public void removeScript(java.lang.String scriptTagId)
- Specified by:
removeScript
in interfacecom.thoughtworks.selenium.Selenium
-
removeSelection
public void removeSelection(java.lang.String locator, java.lang.String optionLocator)
- Specified by:
removeSelection
in interfacecom.thoughtworks.selenium.Selenium
-
retrieveLastRemoteControlLogs
public java.lang.String retrieveLastRemoteControlLogs()
- Specified by:
retrieveLastRemoteControlLogs
in interfacecom.thoughtworks.selenium.Selenium
-
rollup
public void rollup(java.lang.String rollupName, java.lang.String kwargs)
- Specified by:
rollup
in interfacecom.thoughtworks.selenium.Selenium
-
runScript
public void runScript(java.lang.String script)
- Specified by:
runScript
in interfacecom.thoughtworks.selenium.Selenium
-
select
public void select(java.lang.String selectLocator, java.lang.String optionLocator)
- Specified by:
select
in interfacecom.thoughtworks.selenium.Selenium
-
selectFrame
public void selectFrame(java.lang.String locator)
- Specified by:
selectFrame
in interfacecom.thoughtworks.selenium.Selenium
-
selectPopUp
public void selectPopUp(java.lang.String windowID)
- Specified by:
selectPopUp
in interfacecom.thoughtworks.selenium.Selenium
-
selectWindow
public void selectWindow(java.lang.String windowID)
- Specified by:
selectWindow
in interfacecom.thoughtworks.selenium.Selenium
-
setBrowserLogLevel
public void setBrowserLogLevel(java.lang.String logLevel)
- Specified by:
setBrowserLogLevel
in interfacecom.thoughtworks.selenium.Selenium
-
setContext
public void setContext(java.lang.String context)
- Specified by:
setContext
in interfacecom.thoughtworks.selenium.Selenium
-
setCursorPosition
public void setCursorPosition(java.lang.String locator, java.lang.String position)
- Specified by:
setCursorPosition
in interfacecom.thoughtworks.selenium.Selenium
-
setExtensionJs
public void setExtensionJs(java.lang.String extensionJs)
- Specified by:
setExtensionJs
in interfacecom.thoughtworks.selenium.Selenium
-
setMouseSpeed
public void setMouseSpeed(java.lang.String pixels)
- Specified by:
setMouseSpeed
in interfacecom.thoughtworks.selenium.Selenium
-
setSpeed
public void setSpeed(java.lang.String value)
- Specified by:
setSpeed
in interfacecom.thoughtworks.selenium.Selenium
-
setTimeout
public void setTimeout(java.lang.String timeout)
- Specified by:
setTimeout
in interfacecom.thoughtworks.selenium.Selenium
-
shiftKeyDown
public void shiftKeyDown()
- Specified by:
shiftKeyDown
in interfacecom.thoughtworks.selenium.Selenium
-
shiftKeyUp
public void shiftKeyUp()
- Specified by:
shiftKeyUp
in interfacecom.thoughtworks.selenium.Selenium
-
showContextualBanner
public void showContextualBanner()
- Specified by:
showContextualBanner
in interfacecom.thoughtworks.selenium.Selenium
-
showContextualBanner
public void showContextualBanner(java.lang.String className, java.lang.String methodName)
- Specified by:
showContextualBanner
in interfacecom.thoughtworks.selenium.Selenium
-
shutDownSeleniumServer
public void shutDownSeleniumServer()
- Specified by:
shutDownSeleniumServer
in interfacecom.thoughtworks.selenium.Selenium
-
start
public void start()
- Specified by:
start
in interfacecom.thoughtworks.selenium.Selenium
-
start
public void start(java.lang.Object optionsObject)
- Specified by:
start
in interfacecom.thoughtworks.selenium.Selenium
-
start
public void start(java.lang.String optionsString)
- Specified by:
start
in interfacecom.thoughtworks.selenium.Selenium
-
stop
public void stop()
- Specified by:
stop
in interfacecom.thoughtworks.selenium.Selenium
-
submit
public void submit(java.lang.String formLocator)
- Specified by:
submit
in interfacecom.thoughtworks.selenium.Selenium
-
type
public void type(java.lang.String locator, java.lang.String value)
- Specified by:
type
in interfacecom.thoughtworks.selenium.Selenium
-
typeKeys
public void typeKeys(java.lang.String locator, java.lang.String value)
- Specified by:
typeKeys
in interfacecom.thoughtworks.selenium.Selenium
-
uncheck
public void uncheck(java.lang.String locator)
- Specified by:
uncheck
in interfacecom.thoughtworks.selenium.Selenium
-
useXpathLibrary
public void useXpathLibrary(java.lang.String libraryName)
- Specified by:
useXpathLibrary
in interfacecom.thoughtworks.selenium.Selenium
-
waitForCondition
public void waitForCondition(java.lang.String script, java.lang.String timeout)
- Specified by:
waitForCondition
in interfacecom.thoughtworks.selenium.Selenium
-
waitForCondition
protected void waitForCondition(org.openqa.selenium.support.ui.ExpectedCondition condition)
-
waitForCondition
protected void waitForCondition(org.openqa.selenium.support.ui.ExpectedCondition condition, long timeoutSeconds)
-
waitForFrameToLoad
public void waitForFrameToLoad(java.lang.String frameAddress, java.lang.String timeout)
- Specified by:
waitForFrameToLoad
in interfacecom.thoughtworks.selenium.Selenium
-
waitForPageToLoad
public void waitForPageToLoad(java.lang.String timeout)
Waits for page to load, then waits for initialization to finish, which is recognized by thedata-page-initialized
attribute being set to true on the body element. Polls at increasing intervals, for up-to 30 seconds (that's extraordinarily long, but helps sometimes when manually debugging a page that doesn't have the floating console enabled)..- Specified by:
waitForPageToLoad
in interfacecom.thoughtworks.selenium.Selenium
-
waitForPopUp
public void waitForPopUp(java.lang.String windowID, java.lang.String timeout)
- Specified by:
waitForPopUp
in interfacecom.thoughtworks.selenium.Selenium
-
windowFocus
public void windowFocus()
- Specified by:
windowFocus
in interfacecom.thoughtworks.selenium.Selenium
-
windowMaximize
public void windowMaximize()
- Specified by:
windowMaximize
in interfacecom.thoughtworks.selenium.Selenium
-
scrollIntoView
public void scrollIntoView(org.openqa.selenium.WebElement element)
-
reportAndThrowAssertionError
protected final void reportAndThrowAssertionError(java.lang.String message, java.lang.Object... arguments)
Formats a message from the provided arguments, which is written to System.err. In addition, captures the AUT's markup, screenshot, and a report to the output directory.- Parameters:
message
-arguments
-- Since:
- 5.4
-
unreachable
protected final void unreachable()
-
openBaseURL
protected final void openBaseURL()
Open the getBaseURL(), and waits for the page to load.
-
assertText
protected final void assertText(java.lang.String locator, java.lang.String expected)
Asserts the text of an element, identified by the locator.- Parameters:
locator
- identifies the element whose text value is to be assertedexpected
- expected value for the element's text
-
assertTextPresent
protected final void assertTextPresent(java.lang.String... text)
-
assertTextNotPresent
protected final void assertTextNotPresent(java.lang.String... text)
-
assertSourcePresent
protected final void assertSourcePresent(java.lang.String... expected)
Assets that each string provided is present somewhere in the current document.- Parameters:
expected
- string expected to be present
-
clickAndWait
protected final void clickAndWait(java.lang.String locator)
Click a link identified by a locator, then wait for the resulting page to load. This is not useful for Ajax updates, just normal full-page refreshes.- Parameters:
locator
- identifies the link to click
-
waitForPageToLoad
protected final void waitForPageToLoad()
Waits for the page to load (up to 15 seconds). This is invoked after clicking on an element that forces a full page refresh.
-
assertAttribute
protected final void assertAttribute(java.lang.String locator, java.lang.String expected)
Used when the locator identifies an attribute, not an element.- Parameters:
locator
- identifies the attribute whose value is to be assertedexpected
- expected value for the attribute
-
assertFieldValue
protected final void assertFieldValue(java.lang.String locator, java.lang.String expected)
Assets that the value in the field matches the expectation- Parameters:
locator
- identifies the fieldexpected
- expected value for the field- Since:
- 5.3
-
openLinks
protected final void openLinks(java.lang.String... linkText)
Opens the base URL, then clicks through a series of links to get to a desired application state.- Since:
- 5.3
-
sleep
protected final void sleep(long millis)
Sleeps for the indicated number of seconds.- Since:
- 5.3
-
waitForElementToAppear
protected final void waitForElementToAppear(java.lang.String elementId)
Waits for the element with the given client-side id to be present in the DOM ( does not assure that the element is visible).- Parameters:
elementId
- identifies the element- Since:
- 5.3
-
waitForCssSelectorToAppear
protected final void waitForCssSelectorToAppear(java.lang.String selector)
Waits for an element with a given CSS selector to appear.- Parameters:
selector
- the CSS selector to wait.- Since:
- 5.5
-
waitForElementToDisappear
protected final void waitForElementToDisappear(java.lang.String elementId)
Deprecated.Deprecated in 5.4 with no replacementWaits for the element to be removed from the DOM. This implementation depends on window being extended with testSupport.isNotVisible().- Parameters:
elementId
- client-side id of element- Since:
- 5.3
-
waitForVisible
protected final void waitForVisible(java.lang.String selector)
Waits for the element specified by the selector to become visible Note that waitForElementToAppear waits for the element to be present in the dom, visible or not. waitForVisible waits for an element that already exists in the dom to become visible.- Parameters:
selector
- element selector- Since:
- 5.3
-
waitForInvisible
protected final void waitForInvisible(java.lang.String selector)
Waits for the element specified by the selector to become invisible Note that waitForElementToDisappear waits for the element to be absent from the dom, visible or not. waitForInvisible waits for an existing element to become invisible.- Parameters:
selector
- element selector- Since:
- 5.3
-
assertTitle
protected final void assertTitle(java.lang.String expected)
Asserts that the current page's title matches the expected value.- Parameters:
expected
- value for title- Since:
- 5.3
-
waitForAjaxRequestsToComplete
protected final void waitForAjaxRequestsToComplete(java.lang.String timeout)
Deprecated.Deprecated in 5.4 in favor of the version without a timeoutWaits until all active XHR requests are completed.- Parameters:
timeout
- timeout to wait for (no longer used)- Since:
- 5.3
-
waitForAjaxRequestsToComplete
protected final void waitForAjaxRequestsToComplete()
Waits until all active XHR requests (as noted by the t5/core/dom module) have completed.- Since:
- 5.4
-
getCssCount
public java.lang.Number getCssCount(java.lang.String str)
- Specified by:
getCssCount
in interfacecom.thoughtworks.selenium.Selenium
-
convertLocator
protected static org.openqa.selenium.By convertLocator(java.lang.String locator)
-
-