Package com.xceptance.xlt.api.engine.scripting

Class AbstractHtmlUnitCommandsModule

java.lang.Object
com.xceptance.xlt.api.engine.scripting.AbstractHtmlUnitScriptModule
com.xceptance.xlt.api.engine.scripting.AbstractHtmlUnitCommandsModule
public abstract class AbstractHtmlUnitCommandsModule extends AbstractHtmlUnitScriptModule
Base class of all command modules.

  • Constructor Details

    • AbstractHtmlUnitCommandsModule

      public AbstractHtmlUnitCommandsModule()

  • Method Details

    • execute

      protected abstract HtmlPage execute(HtmlPage page) throws Exception
      Executes the module steps.
      Parameters:
      page - the HTML page to start at
      Returns:
      the resulting HTML page
      Throws:
      Exception

    • run

      public HtmlPage run(HtmlPage page) throws Exception
      Runs the module.
      Parameters:
      page - the HTML page to start at
      Returns:
      the resulting HTML page
      Throws:
      Exception

    • addSelection

      protected HtmlPage addSelection(String select, String option)
      Adds the given option of the given select to the current selection.
      Parameters:
      select - the select
      option - the option to be added to current selection

    • assertAttribute

      protected void assertAttribute(String attributeLocator, String textPattern)
      Asserts that the value of the attribute identified by the given attribute locator matches the given text pattern.
      Parameters:
      attributeLocator - the attribute locator
      textPattern - the text pattern that the attribute value must match

    • assertAttribute

      protected void assertAttribute(String elementLocator, String attributeName, String textPattern)
      Asserts that the value of the attribute identified by the given element locator and attribute name matches the given text pattern.
      Parameters:
      elementLocator - the element locator
      attributeName - the name of the attribute
      textPattern - the text pattern that the attribute value must match

    • assertChecked

      protected void assertChecked(String elementLocator)
      Asserts that the given checkbox/radio button is checked.
      Parameters:
      elementLocator - the checkbox/radio button element locator

    • assertClass

      protected void assertClass(String elementLocator, String clazzString)
      Asserts that the given element has the given class(es).
      Parameters:
      elementLocator - the element locator
      clazzString - the class(es) string

    • assertElementCount

      protected void assertElementCount(String elementLocator, int count)
      Asserts that the number of elements found by using the given element locator is equal to the given count.
      Parameters:
      elementLocator - the element locator
      count - the number of elements

    • assertElementCount

      protected void assertElementCount(String elementLocator, String count)
      Asserts that the number of elements found by using the given element locator is equal to the given count.
      Parameters:
      elementLocator - the element locator
      count - the number of elements

    • assertElementPresent

      protected void assertElementPresent(String elementLocator)
      Asserts that the given element is present.
      Parameters:
      elementLocator - locator identifying the element that should be present

    • assertEval

      protected void assertEval(String expression, String textPattern)
      Asserts that evaluating the given expression matches the given text pattern.
      Parameters:
      expression - the expression to evaluate
      textPattern - the text pattern that the evaluation result must match

    • assertLoadTime

      protected void assertLoadTime(long loadTime)
      Asserts that the time needed to load a page does not exceed the given value.
      Parameters:
      loadTime - maximum load time in milliseconds

    • assertLoadTime

      protected void assertLoadTime(String loadTime)
      Asserts that the time needed to load a page does not exceed the given value.
      Parameters:
      loadTime - maximum load time in milliseconds

    • assertNotAttribute

      protected void assertNotAttribute(String attributeLocator, String textPattern)
      Asserts that the value of the attribute identified by the given attribute locator does NOT match the given text pattern.
      Parameters:
      attributeLocator - the attribute locator
      textPattern - the text pattern that the attribute value must NOT match

    • assertNotAttribute

      protected void assertNotAttribute(String elementLocator, String attributeName, String textPattern)
      Asserts that the value of the attribute identified by the given element locator and attribute name does NOT match the given text pattern.
      Parameters:
      elementLocator - the element locator
      attributeName - the name of the attribute
      textPattern - the text pattern that the attribute value must NOT match

    • assertNotChecked

      protected void assertNotChecked(String elementLocator)
      Asserts that the given checkbox/radio button is unchecked.
      Parameters:
      elementLocator - the checkbox/radio button element locator

    • assertNotClass

      protected void assertNotClass(String elementLocator, String clazzString)
      Asserts that the given element doesn't have the given class(es).
      Parameters:
      elementLocator - the element locator
      clazzString - the class(es) string

    • assertNotElementCount

      protected void assertNotElementCount(String elementLocator, int count)
      Asserts that the number of elements found by using the given element locator is unequal to the given count.
      Parameters:
      elementLocator - the element locator
      count - the number of elements

    • assertNotElementCount

      protected void assertNotElementCount(String elementLocator, String count)
      Asserts that the number of elements found by using the given element locator is unequal to the given count.
      Parameters:
      elementLocator - the element locator
      count - the number of elements

    • assertNotElementPresent

      protected void assertNotElementPresent(String elementLocator)
      Asserts that the given element is not present.
      Parameters:
      elementLocator - locator identifying the element that should be NOT present

    • assertNotEval

      protected void assertNotEval(String expression, String textPattern)
      Asserts that evaluating the given expression does NOT match the given text pattern.
      Parameters:
      expression - the expression to evaluate
      textPattern - the text pattern that the evaluation result must NOT match

    • assertNotSelectedId

      protected void assertNotSelectedId(String selectLocator, String idPattern)
      Asserts that no ID of all selected options of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      idPattern - ID pattern that must not patch

    • assertNotSelectedIndex

      protected void assertNotSelectedIndex(String selectLocator, String indexPattern)
      Asserts that the option of the given select element at the given index is not selected.
      Parameters:
      selectLocator - the select element locator
      indexPattern - the option index pattern

    • assertNotSelectedLabel

      protected void assertNotSelectedLabel(String selectLocator, String labelPattern)
      Asserts that no label of all selected options of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      labelPattern - the label pattern that must not match

    • assertNotSelectedValue

      protected void assertNotSelectedValue(String selectLocator, String valuePattern)
      Asserts that no value of all selected options of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      valuePattern - the value pattern that must not match

    • assertNotStyle

      protected void assertNotStyle(String elementLocator, String styleText)
      Asserts that the effective style of the element identified by the given element locator does NOT match the given style.
      Parameters:
      elementLocator - the element locator
      styleText - the style that must NOT match (e.g. width: 10px; overflow: hidden;)

    • assertNotText

      protected void assertNotText(String elementLocator, String text)
      Asserts that the embedded text of the given element does not contain the given text.
      Parameters:
      elementLocator - locator identifying the element
      text - the text that should not be embedded in the given element

    • assertNotTextPresent

      protected void assertNotTextPresent(String text)
      Asserts that the given text is not present on the page.
      Parameters:
      text - the text that should NOT be present

    • assertNotTitle

      protected void assertNotTitle(String title)
      Asserts that the page title does not match the given title.
      Parameters:
      title - the title that should not match

    • assertNotValue

      protected void assertNotValue(String elementLocator, String valuePattern)
      Asserts that the value of the given element doesn't match the given value. If the element is a <textarea> this method asserts that the containing text doesn't match the given value.
      Parameters:
      elementLocator - locator identifying the element whose value doesn't match the given value
      valuePattern - the value that doesn't match the given element's value

    • assertNotVisible

      protected void assertNotVisible(String elementLocator)
      Asserts that the given element is invisible.
      Parameters:
      elementLocator - the element locator

    • assertNotXpathCount

      protected void assertNotXpathCount(String xpath, int count)
      Asserts that the number of elements locatable by the given XPath expression is not equal to the given count.
      Parameters:
      xpath - the XPath expression
      count - the number of elements that should NOT be equal to the actual number of elements matching the given XPath expression

    • assertNotXpathCount

      protected void assertNotXpathCount(String xpath, String count)
      Asserts that the number of elements locatable by the given XPath expression is not equal to the given count.
      Parameters:
      xpath - the XPath expression
      count - the number of elements that should NOT be equal to the actual number of elements matching the given XPath expression

    • assertPageSize

      protected void assertPageSize(long pageSize)
      Asserts that the size of the actual page (including images etc.) does not exceed the given value.
      Parameters:
      pageSize - the number of bytes the page size must not exceed

    • assertPageSize

      protected void assertPageSize(String pageSize)
      Asserts that the size of the actual page (including images etc.) does not exceed the given value.
      Parameters:
      pageSize - the number of bytes the page size must not exceed

    • assertSelectedId

      protected void assertSelectedId(String selectLocator, String idPattern)
      Asserts that the ID of at least one selected option of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      idPattern - ID pattern that must match

    • assertSelectedIndex

      protected void assertSelectedIndex(String selectLocator, String indexPattern)
      Asserts that the option of the given select element at the given index is selected.
      Parameters:
      selectLocator - the select element locator
      indexPattern - the option index pattern

    • assertSelectedLabel

      protected void assertSelectedLabel(String selectLocator, String labelPattern)
      Asserts that the label of at least one selected option of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      labelPattern - the label pattern that must match

    • assertSelectedValue

      protected void assertSelectedValue(String selectLocator, String valuePattern)
      Asserts that the value of at least one selected option of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      valuePattern - the value pattern that must match

    • assertStyle

      protected void assertStyle(String elementLocator, String styleText)
      Asserts that the effective style of the element identified by the given element locator matches the given style.
      Parameters:
      elementLocator - the element locator
      styleText - the style to match (e.g. width: 10px; overflow: hidden;)

    • assertText

      protected void assertText(String elementLocator, String text)
      Asserts that the text embedded by the given element contains the given text.
      Parameters:
      elementLocator - locator identifying the element whose text should contain the given text
      text - the text that should be embedded in the given element

    • assertTextPresent

      protected void assertTextPresent(String text)
      Asserts that the given text is present.
      Parameters:
      text - the text that should be present

    • assertTitle

      protected void assertTitle(String title)
      Asserts that the given title matches the page title.
      Parameters:
      title - the title that should match the page title

    • assertValue

      protected void assertValue(String elementLocator, String valuePattern)
      Asserts that the value of the given element matches the given value. If the element is a <textarea> this method asserts that the containing text matches the given value.
      Parameters:
      elementLocator - locator identifying the element whose value should match the given value
      valuePattern - the value that should match the given element's value

    • assertVisible

      protected void assertVisible(String elementLocator)
      Asserts that the given element is visible.
      Parameters:
      elementLocator - the element locator

    • assertXpathCount

      protected void assertXpathCount(String xpath, int count)
      Asserts that the number of elements locatable by the given XPath expression is equal to the given count.
      Parameters:
      xpath - the XPath expression
      count - the number of elements that must match the given XPath expression

    • assertXpathCount

      protected void assertXpathCount(String xpath, String count)
      Asserts that the number of elements locatable by the given XPath expression is equal to the given count.
      Parameters:
      xpath - the XPath expression
      count - the number of elements that must match the given XPath expression

    • check

      protected HtmlPage check(String elementLocator) throws IOException
      Checks/toggles the given element.
      Parameters:
      elementLocator - locator identifying the element to be checked/toggled
      Throws:
      IOException

    • checkAndWait

      protected HtmlPage checkAndWait(String elementLocator) throws IOException
      Checks/toggles the given element and waits for some activity to complete.
      Parameters:
      elementLocator - locator identifying the element to be checked/toggled
      Throws:
      IOException

    • click

      protected HtmlPage click(String elementLocator) throws IOException
      Clicks the given element.
      Parameters:
      elementLocator - locator identifying the element to be clicked.
      Throws:
      IOException

    • clickAndWait

      protected HtmlPage clickAndWait(String elementLocator) throws IOException
      Clicks the given element and waits for some activity to complete.
      Parameters:
      elementLocator - locator identifying the element to be clicked
      Throws:
      IOException

    • close

      protected void close()
      Closes the current window if it is a top-level window.

    • contextMenu

      protected HtmlPage contextMenu(String elementLocator)
      Simulates a right-click on the given element.
      Parameters:
      elementLocator - locator identifying the element to fire events at

    • contextMenuAt

      protected HtmlPage contextMenuAt(String elementLocator, String coordinates)
      Simulates a right-click at the given coordinates (relative to the given element).
      Parameters:
      elementLocator - locator identifying the target element
      coordinates - the coordinates relative to the given element

    • contextMenuAt

      protected HtmlPage contextMenuAt(String elementLocator, int coordX, int coordY)
      Simulates a right-click at the given coordinates (relative to the given element).
      Parameters:
      elementLocator - locator identifying the target element
      coordX - the X coordinate relative to the given element
      coordY - the Y coordinate relative to the given element

    • createCookie

      protected void createCookie(String cookie)
      Creates a new cookie. The new cookie will be stored as session cookie for the current path and domain.
      Parameters:
      cookie - name value pair of the new cookie

    • createCookie

      protected void createCookie(String cookie, String options)
      Creates a new cookie.
      Parameters:
      cookie - name value pair of the new cookie
      options - cookie creation options (path, max_age and domain)

    • deleteAllVisibleCookies

      protected void deleteAllVisibleCookies()
      Removes all cookies visible to the current page.

    • deleteCookie

      protected void deleteCookie(String name)
      Removes the cookie with the specified name.
      Parameters:
      name - the cookie's name

    • deleteCookie

      protected void deleteCookie(String name, String options)
      Removes the cookie with the specified name.
      Parameters:
      name - the cookie's name
      options - cookie removal options (path, domain and recurse)

    • doubleClick

      protected HtmlPage doubleClick(String elementLocator) throws IOException
      Double-clicks the given element.
      Parameters:
      elementLocator - locator identifying the element to be double-clicked
      Throws:
      IOException

    • doubleClickAndWait

      protected HtmlPage doubleClickAndWait(String elementLocator) throws IOException
      Double-clicks the given element and waits for a page to be loaded.
      Parameters:
      elementLocator - locator identifying the element to be double-clicked
      Throws:
      IOException

    • echo

      protected void echo(String message)
      Prints the given message to the log.
      Parameters:
      message - the message to print

    • mouseDown

      protected HtmlPage mouseDown(String elementLocator)
      Presses the left mouse button on an element, but does not release the button yet.
      Parameters:
      elementLocator - locator identifying the target element

    • mouseDownAt

      protected HtmlPage mouseDownAt(String elementLocator, String coordinates)
      Presses the left mouse button at the given coordinates (relative to the given element), but does not release the button yet.
      Parameters:
      elementLocator - locator identifying the target element
      coordinates - the coordinates relative to the given element

    • mouseDownAt

      protected HtmlPage mouseDownAt(String elementLocator, int coordX, int coordY)
      Presses the left mouse button at the given coordinates (relative to the given element), but does not release the button yet.
      Parameters:
      elementLocator - locator identifying the target element
      coordX - the X coordinate relative to the given element
      coordY - the Y coordinate relative to the given element

    • mouseMove

      protected HtmlPage mouseMove(String elementLocator)
      Moves the mouse to the given element.
      Parameters:
      elementLocator - locator identifying the target element

    • mouseMoveAt

      protected HtmlPage mouseMoveAt(String elementLocator, String coordinates)
      Moves the mouse to the given coordinates (relative to the given element).
      Parameters:
      elementLocator - locator identifying the target element
      coordinates - the coordinates relative to the given element

    • mouseMoveAt

      protected HtmlPage mouseMoveAt(String elementLocator, int coordX, int coordY)
      Moves the mouse to the given coordinates (relative to the given element).
      Parameters:
      elementLocator - locator identifying the target element
      coordX - the X coordinate relative to the given element
      coordY - the Y coordinate relative to the given element

    • mouseOut

      protected HtmlPage mouseOut(String elementLocator)
      Moves the mouse out of the element's bounding box.
      Parameters:
      elementLocator - locator identifying the target element

    • mouseOver

      protected HtmlPage mouseOver(String elementLocator)
      Hovers the mouse over an element.
      Parameters:
      elementLocator - locator identifying the target element

    • mouseUp

      protected HtmlPage mouseUp(String elementLocator)
      Releases the left mouse button on an element.
      Parameters:
      elementLocator - locator identifying the target element

    • mouseUpAt

      protected HtmlPage mouseUpAt(String elementLocator, String coordinates)
      Releases the left mouse button at the given coordinates (relative to the given element).
      Parameters:
      elementLocator - locator identifying the target element
      coordinates - the coordinates relative to the given element

    • mouseUpAt

      protected HtmlPage mouseUpAt(String elementLocator, int coordX, int coordY)
      Releases the left mouse button at the given coordinates (relative to the given element).
      Parameters:
      elementLocator - locator identifying the target element
      coordX - the X coordinate relative to the given element
      coordY - the Y coordinate relative to the given element

    • open

      protected HtmlPage open(String urlToOpen) throws Exception
      Opens the given URL.
      Parameters:
      urlToOpen - the URL to open
      Returns:
      HTML page located at the given URL
      Throws:
      Exception - thrown if access to the given URL has failed

    • open

      protected HtmlPage open(URL urlToOpen) throws Exception
      Opens the given URL.
      Parameters:
      urlToOpen - the URL to open
      Returns:
      HTML page located at the given URL
      Throws:
      Exception - thrown if access to the given URL has failed

    • pause

      protected HtmlPage pause(long waitingTime)
      Waits the given time.
      Parameters:
      waitingTime - the time in milliseconds to wait

    • pause

      protected HtmlPage pause(String waitingTime)
      Waits the given time.
      Parameters:
      waitingTime - the time in milliseconds to wait

    • removeSelection

      protected HtmlPage removeSelection(String select, String option)
      Removes the given option of the given select from the current selection.
      Parameters:
      select - the select
      option - the option to be removed from the current selection

    • select

      protected HtmlPage select(String select, String option)
      Selects the given option of the given select.
      Parameters:
      select - the select
      option - the option to select

    • selectAndWait

      protected HtmlPage selectAndWait(String select, String option)
      Selects the given option of the given select and waits for some activity to complete.
      Parameters:
      select - the select
      option - the option to select

    • selectFrame

      protected HtmlPage selectFrame(String frameTarget)
      Selects the given frame.
      Parameters:
      frameTarget - the frame to be selected

    • selectWindow

      protected HtmlPage selectWindow()
      Selects the top-level window.

    • selectWindow

      protected HtmlPage selectWindow(String windowTarget)
      Selects the given window.
      Parameters:
      windowTarget - the window to be selected

    • setTimeout

      protected void setTimeout(long timeout)
      Sets the timeout to the given value.
      Parameters:
      timeout - the new timeout in milliseconds

    • setTimeout

      protected void setTimeout(String timeout)
      Sets the timeout to the given value.
      Parameters:
      timeout - the new timeout in milliseconds

    • store

      protected void store(String text, String variableName)
      Stores the given text to the given variable.
      Parameters:
      text - the text to store
      variableName - the variable name

    • storeAttribute

      protected void storeAttribute(String attributeLocator, String variableName)
      Stores the value of the attribute identified by the given attribute locator to the given variable
      Parameters:
      attributeLocator - the attribute locator
      variableName - the variable name

    • storeAttribute

      protected void storeAttribute(String elementLocator, String attributeName, String variableName)
      Stores the value of the given element and attribute to the given variable.
      Parameters:
      elementLocator - the element locator
      attributeName - the name of the attribute
      variableName - the variable name

    • storeElementCount

      protected void storeElementCount(String elementLocator, String variableName)
      Stores that the number of elements found by using the given element locator to the given variable.
      Parameters:
      elementLocator - the element locator
      variableName - the variable name

    • storeEval

      protected void storeEval(String expression, String variableName)
      Stores the result of evaluating the given expression to the given variable.
      Parameters:
      expression - the expression to evaluate
      variableName - the variable

    • storeText

      protected void storeText(String elementLocator, String variableName)
      Stores the text of the element identified by the given locator to the given variable.
      Parameters:
      elementLocator - the element locator
      variableName - the variable

    • storeTitle

      protected void storeTitle(String variableName)
      Stores the title of the currently active document to the given variable.
      Parameters:
      variableName - the name of the variable

    • storeValue

      protected void storeValue(String elementLocator, String variableName)
      Stores the value (in case of a <textarea> the contained text) of the element identified by the given locator to the given variable.
      Parameters:
      elementLocator - the element locator
      variableName - the variable

    • storeXpathCount

      protected void storeXpathCount(String xpath, String variableName)
      Stores the number of elements matching the given XPath expression to the given variable.
      Parameters:
      xpath - the XPath expression
      variableName - the variable

    • submit

      protected HtmlPage submit(String form) throws Exception
      Submits the given form.
      Parameters:
      form - the form to submit
      Throws:
      Exception

    • submitAndWait

      protected HtmlPage submitAndWait(String form)
      Submits the given form and waits for some activity to complete.
      Parameters:
      form - the form to submit

    • type

      protected HtmlPage type(String elementLocator, String text) throws IOException
      Types the given text into the given input field.
      Parameters:
      elementLocator - locator identifying the input field
      text - the text to be typed
      Throws:
      IOException

    • typeAndWait

      protected HtmlPage typeAndWait(String elementLocator, String text)
      Types the given text into the given input field and waits for some activity to complete.
      Parameters:
      elementLocator - locator identifying the input field
      text - the text to be typed

    • uncheck

      protected HtmlPage uncheck(String elementLocator) throws IOException
      Unchecks the given checkbox/radio button.
      Parameters:
      elementLocator - locator identifying the checkbox/radio button
      Throws:
      IOException

    • uncheckAndWait

      protected HtmlPage uncheckAndWait(String elementLocator) throws IOException
      Unchecks the given checkbox/radio button and waits for a page load.
      Parameters:
      elementLocator - locator identifying the checkbox/radio button
      Throws:
      IOException

    • waitForAttribute

      protected HtmlPage waitForAttribute(String attributeLocator, String textPattern)
      Waits until the value of the attribute identified by the given attribute locator matches the given text pattern.
      Parameters:
      attributeLocator - the attribute locator
      textPattern - the text pattern

    • waitForAttribute

      protected HtmlPage waitForAttribute(String elementLocator, String attributeName, String textPattern)
      Waits until the value of the given element and attribute matches the given text pattern.
      Parameters:
      elementLocator - the element locator
      attributeName - the name of the attribute
      textPattern - the text pattern

    • waitForChecked

      protected HtmlPage waitForChecked(String elementLocator)
      Waits until the given checkbox/radio button becomes checked.
      Parameters:
      elementLocator - the checkbox/radio button element locator

    • waitForClass

      protected HtmlPage waitForClass(String elementLocator, String clazzString)
      Waits until the given element has the given class(es).
      Parameters:
      elementLocator - the element locator
      clazzString - the class(es) string

    • waitForElementCount

      protected HtmlPage waitForElementCount(String elementLocator, int count)
      Waits until the number of elements found by using the given element locator is equal to the given count.
      Parameters:
      elementLocator - the element locator
      count - the number of elements

    • waitForElementCount

      protected HtmlPage waitForElementCount(String elementLocator, String count)
      Waits until the number of elements found by using the given element locator is equal to the given count.
      Parameters:
      elementLocator - the element locator
      count - the number of elements

    • waitForElementPresent

      protected HtmlPage waitForElementPresent(String elementLocator)
      Waits for the given element to appear.
      Parameters:
      elementLocator - locator identifying the element to wait for

    • waitForEval

      protected HtmlPage waitForEval(String expression, String textPattern)
      Waits until the result of evaluating the given expression matches the given text pattern.
      Parameters:
      expression - the expression to evaluate
      textPattern - textPattern the text pattern the evaluation result must match

    • waitForNotAttribute

      protected HtmlPage waitForNotAttribute(String attributeLocator, String textPattern)
      Waits until the value of the attribute identified by the given attribute locator does NOT match the given text pattern.
      Parameters:
      attributeLocator - the attribute locator
      textPattern - the text pattern that must NOT match

    • waitForNotAttribute

      protected HtmlPage waitForNotAttribute(String elementLocator, String attributeName, String textPattern)
      Waits until the value of the given element and attribute does NOT match the given text pattern.
      Parameters:
      elementLocator - the element locator
      attributeName - the name of the attribute
      textPattern - the text pattern

    • waitForNotChecked

      protected HtmlPage waitForNotChecked(String elementLocator)
      Waits until the given checkbox/radio button becomes unchecked.
      Parameters:
      elementLocator - the checkbox/radio button element locator

    • waitForNotClass

      protected HtmlPage waitForNotClass(String elementLocator, String clazzString)
      Waits until the given element doesn't have the given class(es).
      Parameters:
      elementLocator - the element locator
      clazzString - the class(es) string

    • waitForNotElementCount

      protected HtmlPage waitForNotElementCount(String elementLocator, int count)
      Waits until the number of elements found by using the given element locator is unequal to the given count.
      Parameters:
      elementLocator - the element locator
      count - the number of elements

    • waitForNotElementCount

      protected HtmlPage waitForNotElementCount(String elementLocator, String count)
      Waits until the number of elements found by using the given element locator is unequal to the given count.
      Parameters:
      elementLocator - the element locator
      count - the number of elements

    • waitForNotElementPresent

      protected HtmlPage waitForNotElementPresent(String elementLocator)
      Waits for the given element to disappear.
      Parameters:
      elementLocator - locator identifying the element to disappear

    • waitForNotEval

      protected HtmlPage waitForNotEval(String expression, String textPattern)
      Waits until the result of evaluating the given expression does NOT match the given text pattern.
      Parameters:
      expression - the expression to evaluate
      textPattern - the text pattern that the evaluation result must NOT match

    • waitForNotSelectedId

      protected HtmlPage waitForNotSelectedId(String selectLocator, String idPattern)
      Waits until no ID of all selected options of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      idPattern - the ID pattern that must not match

    • waitForNotSelectedIndex

      protected HtmlPage waitForNotSelectedIndex(String selectLocator, String indexPattern)
      Waits until the option of the given select element at the given index is not selected.
      Parameters:
      selectLocator - the select element locator
      indexPattern - the option index pattern

    • waitForNotSelectedLabel

      protected HtmlPage waitForNotSelectedLabel(String selectLocator, String labelPattern)
      Waits until no label of all selected options of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      labelPattern - the label pattern

    • waitForNotSelectedValue

      protected HtmlPage waitForNotSelectedValue(String selectLocator, String valuePattern)
      Waits until no value of all selected options of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      valuePattern - the value pattern

    • waitForNotStyle

      protected HtmlPage waitForNotStyle(String elementLocator, String styleText)
      Waits until the effective style of the element identified by the given element locator does NOT match the given style.
      Parameters:
      elementLocator - the element locator
      styleText - the style that must NOT match (e.g. width: 10px; overflow: hidden;)

    • waitForNotText

      protected HtmlPage waitForNotText(String elementLocator, String text)
      Waits for the given text embedded in the given element to disappear/change.
      Parameters:
      elementLocator - locator identifying the element whose embedded text should change
      text - the text that should change/disappear

    • waitForNotTextPresent

      protected HtmlPage waitForNotTextPresent(String text)
      Waits for the given text to disappear/change.
      Parameters:
      text - the text that should disappear/change

    • waitForNotTitle

      protected HtmlPage waitForNotTitle(String title)
      Waits for the given page title change.
      Parameters:
      title - the page title that should change

    • waitForNotValue

      protected void waitForNotValue(String elementLocator, String valuePattern)
      Waits for the given value in the given element to disappear/change.
      Parameters:
      elementLocator - locator identifying the element whose value should change
      valuePattern - the value that should change/disappear

    • waitForNotVisible

      protected HtmlPage waitForNotVisible(String elementLocator)
      Waits until the given element becomes invisible.
      Parameters:
      elementLocator - the element locator

    • waitForNotXpathCount

      protected HtmlPage waitForNotXpathCount(String xpath, int count)
      Waits for the number of elements matching the given XPath expression change to a different value than the given one.
      Parameters:
      xpath - the XPath expression
      count - the number of elements currently matching the given XPath expression

    • waitForNotXpathCount

      protected HtmlPage waitForNotXpathCount(String xpath, String count)
      Waits for the number of elements matching the given XPath expression change to a different value than the given one.
      Parameters:
      xpath - the XPath expression
      count - the number of elements currently matching the given XPath expression

    • waitForPageToLoad

      protected HtmlPage waitForPageToLoad()
      Waits for the page to load.

    • waitForPopUp

      protected void waitForPopUp()
      Waits for any pop-up window to be loaded completely.

    • waitForPopUp

      protected void waitForPopUp(String windowID)
      Waits for some pop-up window to be loaded completely.
      Parameters:
      windowID - the ID of the window to wait for

    • waitForPopUp

      protected void waitForPopUp(String windowID, long maxWaitingTime)
      Waits at most the given time for some pop-up window to be loaded completely.
      Parameters:
      windowID - the ID of the window to wait for
      maxWaitingTime - the maximum waiting time

    • waitForPopUp

      protected void waitForPopUp(String windowID, String maxWaitingTime)
      Waits at most the given time for some pop-up window to be loaded completely.
      Parameters:
      windowID - the ID of the window to wait for
      maxWaitingTime - the maximum waiting time

    • waitForSelectedId

      protected HtmlPage waitForSelectedId(String selectLocator, String idPattern)
      Waits until the ID of at least one selected option of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      idPattern - the ID pattern

    • waitForSelectedIndex

      protected HtmlPage waitForSelectedIndex(String selectLocator, String indexPattern)
      Waits until the option of the given select element at the given index is selected.
      Parameters:
      selectLocator - the select element locator
      indexPattern - the option index pattern

    • waitForSelectedLabel

      protected HtmlPage waitForSelectedLabel(String selectLocator, String labelPattern)
      Waits until the label of at least one selected option of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      labelPattern - the label pattern

    • waitForSelectedValue

      protected HtmlPage waitForSelectedValue(String selectLocator, String valuePattern)
      Waits until the value of at least one selected option of the given select element matches the given pattern.
      Parameters:
      selectLocator - the select element locator
      valuePattern - the value pattern

    • waitForStyle

      protected HtmlPage waitForStyle(String elementLocator, String styleText)
      Waits until the effective style of the element identified by the given element locator matches the given style.
      Parameters:
      elementLocator - the element locator
      styleText - the style that must match (e.g. width: 10px; overflow: hidden;)

    • waitForText

      protected HtmlPage waitForText(String elementLocator, String text)
      Waits for the given text embedded in the given element.
      Parameters:
      elementLocator - locator identifying the element whose text should contain the given text
      text - the text to wait for

    • waitForTextPresent

      protected HtmlPage waitForTextPresent(String text)
      Waits for the given text to appear.
      Parameters:
      text - the text to wait for

    • waitForTitle

      protected HtmlPage waitForTitle(String title)
      Waits for the given page title.
      Parameters:
      title - the page title to wait for

    • waitForValue

      protected HtmlPage waitForValue(String elementLocator, String valuePattern)
      Waits for the given value in the given element.
      Parameters:
      elementLocator - locator identifying the element whose value should match the given value
      valuePattern - the value to wait for

    • waitForVisible

      protected HtmlPage waitForVisible(String elementLocator)
      Waits until the given element becomes visible.
      Parameters:
      elementLocator - the element locator

    • waitForXpathCount

      protected HtmlPage waitForXpathCount(String xpath, int count)
      Waits for the number of elements matching the given XPath expression is equal to the given count.
      Parameters:
      xpath - the XPath expression
      count - the number of elements to wait for

    • waitForXpathCount

      protected HtmlPage waitForXpathCount(String xpath, String count)
      Waits for the number of elements matching the given XPath expression is equal to the given count.
      Parameters:
      xpath - the XPath expression
      count - the number of elements to wait for