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 of Selenium and delegates to an instance (setup once per test by testStartup(org.testng.ITestContext, org.testng.xml.XmlTest).
Since:
5.2.0
  • Field Details

  • Constructor Details

  • Method Details

    • testStartup

      @BeforeTest(dependsOnGroups="beforeStartup") public void testStartup(org.testng.ITestContext testContext, org.testng.xml.XmlTest xmlTest) throws 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 the tapestry.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 or TOMCAT_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
      Tests in the beforeStartup group will be run before the start of Selenium. This can be used to programmatically override the above parameter values. This method will be invoked in each subclass, but is set up to only startup the servers once (it checks the ITestContext to see if the necessary keys are already present).
      Parameters:
      testContext - Used to share objects between the launcher and the test suites
      Throws:
      Exception
    • testShutdown

      @AfterTest public void testShutdown(org.testng.ITestContext context)
      Like testStartup(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 Runnable launchWebServer(String container, String webAppFolder, String contextPath, int port, int sslPort) throws Exception
      Invoked from testStartup(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 launched
      webAppFolder - path to the web application context
      contextPath - the path the context is mapped to, usually the empty string
      port - the port number the server should handle
      sslPort - the port number on which the server should handle secure requests
      Returns:
      Runnable used to shut down the server
      Throws:
      Exception
    • setup

      @BeforeClass public void setup(org.testng.ITestContext context)
    • cleanup

      @AfterClass public void cleanup()
    • writeErrorReport

      protected void writeErrorReport(String reportText)
      Delegates to ErrorReporter.writeErrorReport(String) to capture the current page markup in a file for later analysis.
    • getBaseURL

      public String getBaseURL()
      Returns the base URL for the application. This is of the typically http://localhost:9999/ (i.e., it includes a trailing slash). Generally, you should use openLinks(String...) to start from your application's home page.
    • indicateTestMethodName

      @BeforeMethod public void indicateTestMethodName(Method testMethod)
    • cleanupTestMethod

      @AfterMethod public void cleanupTestMethod()
    • addCustomRequestHeader

      public void addCustomRequestHeader(String key, String value)
      Specified by:
      addCustomRequestHeader in interface com.thoughtworks.selenium.Selenium
    • addLocationStrategy

      public void addLocationStrategy(String strategyName, String functionDefinition)
      Specified by:
      addLocationStrategy in interface com.thoughtworks.selenium.Selenium
    • addScript

      public void addScript(String scriptContent, String scriptTagId)
      Specified by:
      addScript in interface com.thoughtworks.selenium.Selenium
    • addSelection

      public void addSelection(String locator, String optionLocator)
      Specified by:
      addSelection in interface com.thoughtworks.selenium.Selenium
    • allowNativeXpath

      public void allowNativeXpath(String allow)
      Specified by:
      allowNativeXpath in interface com.thoughtworks.selenium.Selenium
    • altKeyDown

      public void altKeyDown()
      Specified by:
      altKeyDown in interface com.thoughtworks.selenium.Selenium
    • altKeyUp

      public void altKeyUp()
      Specified by:
      altKeyUp in interface com.thoughtworks.selenium.Selenium
    • answerOnNextPrompt

      public void answerOnNextPrompt(String answer)
      Specified by:
      answerOnNextPrompt in interface com.thoughtworks.selenium.Selenium
    • assignId

      public void assignId(String locator, String identifier)
      Specified by:
      assignId in interface com.thoughtworks.selenium.Selenium
    • attachFile

      public void attachFile(String fieldLocator, String fileLocator)
      Specified by:
      attachFile in interface com.thoughtworks.selenium.Selenium
    • captureEntirePageScreenshot

      public void captureEntirePageScreenshot(String filename, String kwargs)
      Specified by:
      captureEntirePageScreenshot in interface com.thoughtworks.selenium.Selenium
    • captureEntirePageScreenshotToString

      Specified by:
      captureEntirePageScreenshotToString in interface com.thoughtworks.selenium.Selenium
    • captureNetworkTraffic

      Specified by:
      captureNetworkTraffic in interface com.thoughtworks.selenium.Selenium
    • captureScreenshot

      public void captureScreenshot(String filename)
      Specified by:
      captureScreenshot in interface com.thoughtworks.selenium.Selenium
    • captureScreenshotToString

      Specified by:
      captureScreenshotToString in interface com.thoughtworks.selenium.Selenium
    • check

      public void check(String locator)
      Specified by:
      check in interface com.thoughtworks.selenium.Selenium
    • chooseCancelOnNextConfirmation

      Specified by:
      chooseCancelOnNextConfirmation in interface com.thoughtworks.selenium.Selenium
    • chooseOkOnNextConfirmation

      Specified by:
      chooseOkOnNextConfirmation in interface com.thoughtworks.selenium.Selenium
    • click

      public void click(String locator)
      Specified by:
      click in interface com.thoughtworks.selenium.Selenium
    • clickAt

      public void clickAt(String locator, String coordString)
      Specified by:
      clickAt in interface com.thoughtworks.selenium.Selenium
    • close

      public void close()
      Specified by:
      close in interface com.thoughtworks.selenium.Selenium
    • contextMenu

      public void contextMenu(String locator)
      Specified by:
      contextMenu in interface com.thoughtworks.selenium.Selenium
    • contextMenuAt

      public void contextMenuAt(String locator, String coordString)
      Specified by:
      contextMenuAt in interface com.thoughtworks.selenium.Selenium
    • controlKeyDown

      public void controlKeyDown()
      Specified by:
      controlKeyDown in interface com.thoughtworks.selenium.Selenium
    • controlKeyUp

      public void controlKeyUp()
      Specified by:
      controlKeyUp in interface com.thoughtworks.selenium.Selenium
    • createCookie

      public void createCookie(String nameValuePair, String optionsString)
      Specified by:
      createCookie in interface com.thoughtworks.selenium.Selenium
    • deleteAllVisibleCookies

      public void deleteAllVisibleCookies()
      Specified by:
      deleteAllVisibleCookies in interface com.thoughtworks.selenium.Selenium
    • deleteCookie

      public void deleteCookie(String name, String optionsString)
      Specified by:
      deleteCookie in interface com.thoughtworks.selenium.Selenium
    • deselectPopUp

      public void deselectPopUp()
      Specified by:
      deselectPopUp in interface com.thoughtworks.selenium.Selenium
    • doubleClick

      public void doubleClick(String locator)
      Specified by:
      doubleClick in interface com.thoughtworks.selenium.Selenium
    • doubleClickAt

      public void doubleClickAt(String locator, String coordString)
      Specified by:
      doubleClickAt in interface com.thoughtworks.selenium.Selenium
    • dragAndDrop

      public void dragAndDrop(String locator, String movementsString)
      Specified by:
      dragAndDrop in interface com.thoughtworks.selenium.Selenium
    • dragAndDropToObject

      public void dragAndDropToObject(String locatorOfObjectToBeDragged, String locatorOfDragDestinationObject)
      Specified by:
      dragAndDropToObject in interface com.thoughtworks.selenium.Selenium
    • dragdrop

      public void dragdrop(String locator, String movementsString)
      Specified by:
      dragdrop in interface com.thoughtworks.selenium.Selenium
    • fireEvent

      public void fireEvent(String locator, String eventName)
      Specified by:
      fireEvent in interface com.thoughtworks.selenium.Selenium
    • focus

      public void focus(String locator)
      Specified by:
      focus in interface com.thoughtworks.selenium.Selenium
    • getAlert

      public String getAlert()
      Specified by:
      getAlert in interface com.thoughtworks.selenium.Selenium
    • getAllButtons

      public String[] getAllButtons()
      Specified by:
      getAllButtons in interface com.thoughtworks.selenium.Selenium
    • getAllFields

      public String[] getAllFields()
      Specified by:
      getAllFields in interface com.thoughtworks.selenium.Selenium
    • getAllLinks

      public String[] getAllLinks()
      Specified by:
      getAllLinks in interface com.thoughtworks.selenium.Selenium
    • getAllWindowIds

      public String[] getAllWindowIds()
      Specified by:
      getAllWindowIds in interface com.thoughtworks.selenium.Selenium
    • getAllWindowNames

      Specified by:
      getAllWindowNames in interface com.thoughtworks.selenium.Selenium
    • getAllWindowTitles

      Specified by:
      getAllWindowTitles in interface com.thoughtworks.selenium.Selenium
    • getAttribute

      public String getAttribute(String attributeLocator)
      Specified by:
      getAttribute in interface com.thoughtworks.selenium.Selenium
    • getAttributeFromAllWindows

      public String[] getAttributeFromAllWindows(String attributeName)
      Specified by:
      getAttributeFromAllWindows in interface com.thoughtworks.selenium.Selenium
    • getBodyText

      public String getBodyText()
      Specified by:
      getBodyText in interface com.thoughtworks.selenium.Selenium
    • getConfirmation

      Specified by:
      getConfirmation in interface com.thoughtworks.selenium.Selenium
    • getCookie

      public String getCookie()
      Specified by:
      getCookie in interface com.thoughtworks.selenium.Selenium
    • getCookieByName

      public String getCookieByName(String name)
      Specified by:
      getCookieByName in interface com.thoughtworks.selenium.Selenium
    • getCursorPosition

      public Number getCursorPosition(String locator)
      Specified by:
      getCursorPosition in interface com.thoughtworks.selenium.Selenium
    • getElementHeight

      public Number getElementHeight(String locator)
      Specified by:
      getElementHeight in interface com.thoughtworks.selenium.Selenium
    • getElementIndex

      public Number getElementIndex(String locator)
      Specified by:
      getElementIndex in interface com.thoughtworks.selenium.Selenium
    • getElementPositionLeft

      Specified by:
      getElementPositionLeft in interface com.thoughtworks.selenium.Selenium
    • getElementPositionTop

      Specified by:
      getElementPositionTop in interface com.thoughtworks.selenium.Selenium
    • getElementWidth

      public Number getElementWidth(String locator)
      Specified by:
      getElementWidth in interface com.thoughtworks.selenium.Selenium
    • getEval

      public String getEval(String script)
      Specified by:
      getEval in interface com.thoughtworks.selenium.Selenium
    • getExpression

      public String getExpression(String expression)
      Specified by:
      getExpression in interface com.thoughtworks.selenium.Selenium
    • getHtmlSource

      Specified by:
      getHtmlSource in interface com.thoughtworks.selenium.Selenium
    • getLocation

      public String getLocation()
      Specified by:
      getLocation in interface com.thoughtworks.selenium.Selenium
    • getLog

      public String getLog()
      Specified by:
      getLog in interface com.thoughtworks.selenium.Selenium
    • getMouseSpeed

      Specified by:
      getMouseSpeed in interface com.thoughtworks.selenium.Selenium
    • getPrompt

      public String getPrompt()
      Specified by:
      getPrompt in interface com.thoughtworks.selenium.Selenium
    • getSelectedId

      public String getSelectedId(String selectLocator)
      Specified by:
      getSelectedId in interface com.thoughtworks.selenium.Selenium
    • getSelectedIds

      public String[] getSelectedIds(String selectLocator)
      Specified by:
      getSelectedIds in interface com.thoughtworks.selenium.Selenium
    • getSelectedIndex

      public String getSelectedIndex(String selectLocator)
      Specified by:
      getSelectedIndex in interface com.thoughtworks.selenium.Selenium
    • getSelectedIndexes

      public String[] getSelectedIndexes(String selectLocator)
      Specified by:
      getSelectedIndexes in interface com.thoughtworks.selenium.Selenium
    • getSelectedLabel

      public String getSelectedLabel(String selectLocator)
      Specified by:
      getSelectedLabel in interface com.thoughtworks.selenium.Selenium
    • getSelectedLabels

      public String[] getSelectedLabels(String selectLocator)
      Specified by:
      getSelectedLabels in interface com.thoughtworks.selenium.Selenium
    • getSelectedValue

      public String getSelectedValue(String selectLocator)
      Specified by:
      getSelectedValue in interface com.thoughtworks.selenium.Selenium
    • getSelectedValues

      public String[] getSelectedValues(String selectLocator)
      Specified by:
      getSelectedValues in interface com.thoughtworks.selenium.Selenium
    • getSelectOptions

      public String[] getSelectOptions(String selectLocator)
      Specified by:
      getSelectOptions in interface com.thoughtworks.selenium.Selenium
    • getSpeed

      public String getSpeed()
      Specified by:
      getSpeed in interface com.thoughtworks.selenium.Selenium
    • getTable

      public String getTable(String tableCellAddress)
      Specified by:
      getTable in interface com.thoughtworks.selenium.Selenium
    • getText

      public String getText(String locator)
      Specified by:
      getText in interface com.thoughtworks.selenium.Selenium
    • getTitle

      public String getTitle()
      Specified by:
      getTitle in interface com.thoughtworks.selenium.Selenium
    • getValue

      public String getValue(String locator)
      Specified by:
      getValue in interface com.thoughtworks.selenium.Selenium
    • getWhetherThisFrameMatchFrameExpression

      public boolean getWhetherThisFrameMatchFrameExpression(String currentFrameString, String target)
      Specified by:
      getWhetherThisFrameMatchFrameExpression in interface com.thoughtworks.selenium.Selenium
    • getWhetherThisWindowMatchWindowExpression

      public boolean getWhetherThisWindowMatchWindowExpression(String currentWindowString, String target)
      Specified by:
      getWhetherThisWindowMatchWindowExpression in interface com.thoughtworks.selenium.Selenium
    • getXpathCount

      public Number getXpathCount(String xpath)
      Specified by:
      getXpathCount in interface com.thoughtworks.selenium.Selenium
    • goBack

      public void goBack()
      Specified by:
      goBack in interface com.thoughtworks.selenium.Selenium
    • highlight

      public void highlight(String locator)
      Specified by:
      highlight in interface com.thoughtworks.selenium.Selenium
    • ignoreAttributesWithoutValue

      public void ignoreAttributesWithoutValue(String ignore)
      Specified by:
      ignoreAttributesWithoutValue in interface com.thoughtworks.selenium.Selenium
    • isAlertPresent

      public boolean isAlertPresent()
      Specified by:
      isAlertPresent in interface com.thoughtworks.selenium.Selenium
    • isChecked

      public boolean isChecked(String locator)
      Specified by:
      isChecked in interface com.thoughtworks.selenium.Selenium
    • isConfirmationPresent

      public boolean isConfirmationPresent()
      Specified by:
      isConfirmationPresent in interface com.thoughtworks.selenium.Selenium
    • isCookiePresent

      public boolean isCookiePresent(String name)
      Specified by:
      isCookiePresent in interface com.thoughtworks.selenium.Selenium
    • isEditable

      public boolean isEditable(String locator)
      Specified by:
      isEditable in interface com.thoughtworks.selenium.Selenium
    • isElementPresent

      public boolean isElementPresent(String locator)
      Specified by:
      isElementPresent in interface com.thoughtworks.selenium.Selenium
    • isOrdered

      public boolean isOrdered(String locator1, String locator2)
      Specified by:
      isOrdered in interface com.thoughtworks.selenium.Selenium
    • isPromptPresent

      public boolean isPromptPresent()
      Specified by:
      isPromptPresent in interface com.thoughtworks.selenium.Selenium
    • isSomethingSelected

      public boolean isSomethingSelected(String selectLocator)
      Specified by:
      isSomethingSelected in interface com.thoughtworks.selenium.Selenium
    • isTextPresent

      public boolean isTextPresent(String pattern)
      Specified by:
      isTextPresent in interface com.thoughtworks.selenium.Selenium
    • isVisible

      public boolean isVisible(String locator)
      Specified by:
      isVisible in interface com.thoughtworks.selenium.Selenium
    • keyDown

      public void keyDown(String locator, String keySequence)
      Specified by:
      keyDown in interface com.thoughtworks.selenium.Selenium
    • keyDownNative

      public void keyDownNative(String keycode)
      Specified by:
      keyDownNative in interface com.thoughtworks.selenium.Selenium
    • keyPress

      public void keyPress(String locator, String keySequence)
      Specified by:
      keyPress in interface com.thoughtworks.selenium.Selenium
    • keyPressNative

      public void keyPressNative(String keycode)
      Specified by:
      keyPressNative in interface com.thoughtworks.selenium.Selenium
    • keyUp

      public void keyUp(String locator, String keySequence)
      Specified by:
      keyUp in interface com.thoughtworks.selenium.Selenium
    • keyUpNative

      public void keyUpNative(String keycode)
      Specified by:
      keyUpNative in interface com.thoughtworks.selenium.Selenium
    • metaKeyDown

      public void metaKeyDown()
      Specified by:
      metaKeyDown in interface com.thoughtworks.selenium.Selenium
    • metaKeyUp

      public void metaKeyUp()
      Specified by:
      metaKeyUp in interface com.thoughtworks.selenium.Selenium
    • mouseDown

      public void mouseDown(String locator)
      Specified by:
      mouseDown in interface com.thoughtworks.selenium.Selenium
    • mouseDownAt

      public void mouseDownAt(String locator, String coordString)
      Specified by:
      mouseDownAt in interface com.thoughtworks.selenium.Selenium
    • mouseDownRight

      public void mouseDownRight(String locator)
      Specified by:
      mouseDownRight in interface com.thoughtworks.selenium.Selenium
    • mouseDownRightAt

      public void mouseDownRightAt(String locator, String coordString)
      Specified by:
      mouseDownRightAt in interface com.thoughtworks.selenium.Selenium
    • mouseMove

      public void mouseMove(String locator)
      Specified by:
      mouseMove in interface com.thoughtworks.selenium.Selenium
    • mouseMoveAt

      public void mouseMoveAt(String locator, String coordString)
      Specified by:
      mouseMoveAt in interface com.thoughtworks.selenium.Selenium
    • mouseOut

      public void mouseOut(String locator)
      Specified by:
      mouseOut in interface com.thoughtworks.selenium.Selenium
    • mouseOver

      public void mouseOver(String locator)
      Specified by:
      mouseOver in interface com.thoughtworks.selenium.Selenium
    • mouseUp

      public void mouseUp(String locator)
      Specified by:
      mouseUp in interface com.thoughtworks.selenium.Selenium
    • mouseUpAt

      public void mouseUpAt(String locator, String coordString)
      Specified by:
      mouseUpAt in interface com.thoughtworks.selenium.Selenium
    • mouseUpRight

      public void mouseUpRight(String locator)
      Specified by:
      mouseUpRight in interface com.thoughtworks.selenium.Selenium
    • mouseUpRightAt

      public void mouseUpRightAt(String locator, String coordString)
      Specified by:
      mouseUpRightAt in interface com.thoughtworks.selenium.Selenium
    • open

      public void open(String url)
      Specified by:
      open in interface com.thoughtworks.selenium.Selenium
    • open

      public void open(String url, String ignoreResponseCode)
      Specified by:
      open in interface com.thoughtworks.selenium.Selenium
    • openWindow

      public void openWindow(String url, String windowID)
      Specified by:
      openWindow in interface com.thoughtworks.selenium.Selenium
    • refresh

      public void refresh()
      Specified by:
      refresh in interface com.thoughtworks.selenium.Selenium
    • removeAllSelections

      public void removeAllSelections(String locator)
      Specified by:
      removeAllSelections in interface com.thoughtworks.selenium.Selenium
    • removeScript

      public void removeScript(String scriptTagId)
      Specified by:
      removeScript in interface com.thoughtworks.selenium.Selenium
    • removeSelection

      public void removeSelection(String locator, String optionLocator)
      Specified by:
      removeSelection in interface com.thoughtworks.selenium.Selenium
    • retrieveLastRemoteControlLogs

      Specified by:
      retrieveLastRemoteControlLogs in interface com.thoughtworks.selenium.Selenium
    • rollup

      public void rollup(String rollupName, String kwargs)
      Specified by:
      rollup in interface com.thoughtworks.selenium.Selenium
    • runScript

      public void runScript(String script)
      Specified by:
      runScript in interface com.thoughtworks.selenium.Selenium
    • select

      public void select(String selectLocator, String optionLocator)
      Specified by:
      select in interface com.thoughtworks.selenium.Selenium
    • selectFrame

      public void selectFrame(String locator)
      Specified by:
      selectFrame in interface com.thoughtworks.selenium.Selenium
    • selectPopUp

      public void selectPopUp(String windowID)
      Specified by:
      selectPopUp in interface com.thoughtworks.selenium.Selenium
    • selectWindow

      public void selectWindow(String windowID)
      Specified by:
      selectWindow in interface com.thoughtworks.selenium.Selenium
    • setBrowserLogLevel

      public void setBrowserLogLevel(String logLevel)
      Specified by:
      setBrowserLogLevel in interface com.thoughtworks.selenium.Selenium
    • setContext

      public void setContext(String context)
      Specified by:
      setContext in interface com.thoughtworks.selenium.Selenium
    • setCursorPosition

      public void setCursorPosition(String locator, String position)
      Specified by:
      setCursorPosition in interface com.thoughtworks.selenium.Selenium
    • setExtensionJs

      public void setExtensionJs(String extensionJs)
      Specified by:
      setExtensionJs in interface com.thoughtworks.selenium.Selenium
    • setMouseSpeed

      public void setMouseSpeed(String pixels)
      Specified by:
      setMouseSpeed in interface com.thoughtworks.selenium.Selenium
    • setSpeed

      public void setSpeed(String value)
      Specified by:
      setSpeed in interface com.thoughtworks.selenium.Selenium
    • setTimeout

      public void setTimeout(String timeout)
      Specified by:
      setTimeout in interface com.thoughtworks.selenium.Selenium
    • shiftKeyDown

      public void shiftKeyDown()
      Specified by:
      shiftKeyDown in interface com.thoughtworks.selenium.Selenium
    • shiftKeyUp

      public void shiftKeyUp()
      Specified by:
      shiftKeyUp in interface com.thoughtworks.selenium.Selenium
    • showContextualBanner

      public void showContextualBanner()
      Specified by:
      showContextualBanner in interface com.thoughtworks.selenium.Selenium
    • showContextualBanner

      public void showContextualBanner(String className, String methodName)
      Specified by:
      showContextualBanner in interface com.thoughtworks.selenium.Selenium
    • shutDownSeleniumServer

      public void shutDownSeleniumServer()
      Specified by:
      shutDownSeleniumServer in interface com.thoughtworks.selenium.Selenium
    • start

      public void start()
      Specified by:
      start in interface com.thoughtworks.selenium.Selenium
    • start

      public void start(Object optionsObject)
      Specified by:
      start in interface com.thoughtworks.selenium.Selenium
    • start

      public void start(String optionsString)
      Specified by:
      start in interface com.thoughtworks.selenium.Selenium
    • stop

      public void stop()
      Specified by:
      stop in interface com.thoughtworks.selenium.Selenium
    • submit

      public void submit(String formLocator)
      Specified by:
      submit in interface com.thoughtworks.selenium.Selenium
    • type

      public void type(String locator, String value)
      Specified by:
      type in interface com.thoughtworks.selenium.Selenium
    • typeKeys

      public void typeKeys(String locator, String value)
      Specified by:
      typeKeys in interface com.thoughtworks.selenium.Selenium
    • uncheck

      public void uncheck(String locator)
      Specified by:
      uncheck in interface com.thoughtworks.selenium.Selenium
    • useXpathLibrary

      public void useXpathLibrary(String libraryName)
      Specified by:
      useXpathLibrary in interface com.thoughtworks.selenium.Selenium
    • waitForCondition

      public void waitForCondition(String script, String timeout)
      Specified by:
      waitForCondition in interface com.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(String frameAddress, String timeout)
      Specified by:
      waitForFrameToLoad in interface com.thoughtworks.selenium.Selenium
    • waitForPageToLoad

      public void waitForPageToLoad(String timeout)
      Waits for page to load, then waits for initialization to finish, which is recognized by the data-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 interface com.thoughtworks.selenium.Selenium
    • waitForPopUp

      public void waitForPopUp(String windowID, String timeout)
      Specified by:
      waitForPopUp in interface com.thoughtworks.selenium.Selenium
    • windowFocus

      public void windowFocus()
      Specified by:
      windowFocus in interface com.thoughtworks.selenium.Selenium
    • windowMaximize

      public void windowMaximize()
      Specified by:
      windowMaximize in interface com.thoughtworks.selenium.Selenium
    • scrollIntoView

      public void scrollIntoView(org.openqa.selenium.WebElement element)
    • reportAndThrowAssertionError

      protected final void reportAndThrowAssertionError(String message, 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(String locator, String expected)
      Asserts the text of an element, identified by the locator.
      Parameters:
      locator - identifies the element whose text value is to be asserted
      expected - expected value for the element's text
    • assertTextPresent

      protected final void assertTextPresent(String... text)
    • assertTextNotPresent

      protected final void assertTextNotPresent(String... text)
    • assertSourcePresent

      protected final void assertSourcePresent(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(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(String locator, String expected)
      Used when the locator identifies an attribute, not an element.
      Parameters:
      locator - identifies the attribute whose value is to be asserted
      expected - expected value for the attribute
    • assertFieldValue

      protected final void assertFieldValue(String locator, String expected)
      Assets that the value in the field matches the expectation
      Parameters:
      locator - identifies the field
      expected - expected value for the field
      Since:
      5.3
    • openLinks

      protected final void openLinks(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(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(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(String elementId)
      Deprecated.
      Deprecated in 5.4 with no replacement
      Waits 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(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(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(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(String timeout)
      Deprecated.
      Deprecated in 5.4 in favor of the version without a timeout
      Waits 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 Number getCssCount(String str)
      Specified by:
      getCssCount in interface com.thoughtworks.selenium.Selenium
    • convertLocator

      protected static org.openqa.selenium.By convertLocator(String locator)