public abstract class

ThreadLocalWebTestCase

extends TestCase
java.lang.Object
   ↳ junit.framework.Assert
     ↳ junit.framework.TestCase
       ↳ com.atlassian.confluence.ThreadLocalWebTestCase
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

This is a copy of net.sourceforge.jwebunit.junit.WebTestCase (version 1.4.1). This version differs from the original in that it stores its net.sourceforge.jwebunit.junit.WebTester in a thread local instead of a local field. This provides thread safety over the tester if multiple threads share this test case (which is the case with TestNG).

Summary

Public Constructors
ThreadLocalWebTestCase(String name)
ThreadLocalWebTestCase()
Public Methods
void assertButtonNotPresent(String buttonId)
Assert that a button with a given id is not present in the current window.
void assertButtonNotPresentWithText(String text)
Assert that a button with a given text is not present in the current window.
void assertButtonPresent(String buttonId)
Assert that a button with a given id is present in the current window.
void assertButtonPresentWithText(String text)
Assert that a button with a given text is present in the current window.
void assertCheckboxNotPresent(String checkboxName, String checkboxValue)
Assert that a given checkbox is not present.
void assertCheckboxNotPresent(String checkboxName)
Assert that a form checkbox with a given name is not present.
void assertCheckboxNotSelected(String checkBoxName, String checkBoxValue)
Assert that a specific checkbox is not selected.
void assertCheckboxNotSelected(String checkBoxName)
Assert that a specific checkbox is not selected.
void assertCheckboxPresent(String checkboxName, String checkboxValue)
Assert that a given checkbox is present.
void assertCheckboxPresent(String checkboxName)
Assert that a form checkbox with a given name is present.
void assertCheckboxSelected(String checkBoxName, String checkBoxValue)
Assert that a specific checkbox is selected.
void assertCheckboxSelected(String checkBoxName)
Assert that a specific checkbox is selected.
void assertCookiePresent(String cookieName)
Checks to see if a cookie is present in the response.
void assertCookieValueEquals(String cookieName, String expectedValue)
Check to see if a cookie has the given value.
void assertCookieValueMatch(String cookieName, String regexp)
Check to see if a cookie value match the given regexp.
void assertDownloadedFileEquals(URL expected)
Download the current page (or file) and compare it with the given file.
void assertElementNotPresent(String anID)
Assert that an element with a given id is not present.
void assertElementNotPresentByXPath(String xpath)
Assert that an element with a given xpath is not present.
void assertElementPresent(String anID)
Assert that an element with a given id is present.
void assertElementPresentByXPath(String xpath)
Assert that an element with a given xpath is present.
void assertFormElementEmpty(String formElementName)
This method is deprecated. No replacement.
void assertFormElementEquals(String formElementName, String expectedValue)
This method is deprecated. No replacement.
void assertFormElementMatch(String formElementName, String regexp)
This method is deprecated. No replacement.
void assertFormElementNotPresent(String formElementName)
Assert that a form input element with a given name is not present.
void assertFormElementPresent(String formElementName)
Assert that a form input element with a given name is present.
void assertFormNotPresent()
Assert that there is not a form present.
void assertFormNotPresent(String nameOrID)
Assert that there is not a form with the specified name or id present.
void assertFormPresent(String nameOrID)
Assert that there is a form with the specified name or id present.
void assertFormPresent()
Assert that there is a form present.
void assertFramePresent(String frameNameOrId)
Assert that a frame with the given name or ID is present.
void assertHiddenFieldPresent(String formElementName, String expectedValue)
Assert that an input hidden element with name formElementName has the expectedValue value.
void assertImagePresent(String imageSrc, String imageAlt)
void assertImageValid(String imageSrc, String imageAlt)
void assertImageValidAndStore(String imageSrc, String imageAlt, File out)
Asserts that the image with the given src and alt attribute values exist in the page and is an actual reachable image, then saves it as png with the given file name.
void assertKeyInTable(String tableSummaryOrId, String key, Object[] args)
Assert that the value of a given web resource is present in a specific table.
void assertKeyInTable(String tableSummaryOrId, String key)
Assert that the value of a given web resource is present in a specific table.
void assertKeyNotInTable(String tableSummaryOrId, String key)
Assert that the value of a given web resource is not present in a specific table.
void assertKeyNotPresent(String key)
Assert that a web resource's value is not present.
void assertKeyNotPresent(String key, Object[] args)
Assert that a web resource's formatted value is not present.
void assertKeyPresent(String key)
Assert that a web resource's value is present.
void assertKeyPresent(String key, Object[] args)
Assert that a web resource's value (with formatting) is present
void assertKeysInTable(String tableSummaryOrId, String[] keys)
Assert that the values of a set of web resources are all present in a specific table.
void assertKeysInTable(String tableSummaryOrId, String[] keys, Object[][] args)
Assert that the values of a set of web resources are all present in a specific table.
void assertLinkNotPresent(String linkId)
Assert that no link with the given id is present in the response.
void assertLinkNotPresentWithExactText(String linkText, int index)
Assert that no link containing the Exact text is present.
void assertLinkNotPresentWithExactText(String linkText)
Assert that no link containing the Exact text is present.
void assertLinkNotPresentWithImage(String imageFileName)
Assert that a link containing a specified image is not present.
void assertLinkNotPresentWithText(String linkText)
Assert that no link containing the supplied text is present.
void assertLinkNotPresentWithText(String linkText, int index)
Assert that no link containing the supplied text is present.
void assertLinkPresent(String linkId)
Assert that a link with a given id is present in the response.
void assertLinkPresentWithExactText(String linkText)
Assert that a link containing the Exact text is present.
void assertLinkPresentWithExactText(String linkText, int index)
Assert that a link containing the Exact text is present.
void assertLinkPresentWithImage(String imageFileName)
Assert that a link containing a specified image is present.
void assertLinkPresentWithText(String linkText, int index)
Assert that a link containing the supplied text is present.
void assertLinkPresentWithText(String linkText)
Assert that a link containing the supplied text is present.
void assertMatch(String regexp)
Assert that supplied regexp is matched.
void assertMatchInElement(String elementID, String regexp)
Assert that a given element matches a specific regexp.
void assertMatchInTable(String tableSummaryOrId, String[] regexp)
Assert that a set of regexp values are all matched in a specific table.
void assertMatchInTable(String tableSummaryNameOrId, String regexp)
Assert that supplied regexp is matched in a specific table.
void assertNoMatch(String regexp)
Assert that supplied regexp is not present.
void assertNoMatchInElement(String elementID, String regexp)
Assert that a given element does not match a specific regexp.
void assertNoMatchInTable(String tableSummaryNameOrId, String regexp)
Assert that supplied regexp is not present in a specific table.
void assertNoMatchInTable(String tableSummaryNameOrId, String[] regexp)
Assert that none of a set of regexp values are present in a specific table.
void assertRadioOptionNotPresent(String name, String radioOption)
Assert that a specific option is not present in a radio group.
void assertRadioOptionNotSelected(String name, String radioOption)
Assert that a specific option is not selected in a radio group.
void assertRadioOptionPresent(String name, String radioOption)
Assert that a specific option is present in a radio group.
void assertRadioOptionSelected(String name, String radioOption)
Assert that a specific option is selected in a radio group.
void assertResetButtonNotPresent()
Assert that no reset button is present in the current form.
void assertResetButtonNotPresent(String buttonName)
Assert that a reset button with a given name is not present.
void assertResetButtonPresent()
Assert that a reset button is present.
void assertResetButtonPresent(String buttonName)
Assert that a reset button with a given name is present.
void assertSelectOptionNotPresent(String selectName, String optionLabel)
Assert that a specific option is not present in a select box.
void assertSelectOptionPresent(String selectName, String optionLabel)
Assert that a specific option is present in a select box (by label).
void assertSelectOptionValueNotPresent(String selectName, String optionValue)
void assertSelectOptionValuePresent(String selectName, String optionValue)
Assert that a specific option is present in a select box (by value).
void assertSelectOptionValuesEqual(String selectName, String[] expectedValues)
Assert that the values of a select element's options match a given array of strings.
void assertSelectOptionValuesNotEqual(String selectName, String[] optionValues)
Assert that the values of a select element's options do not match a given array of strings.
void assertSelectOptionValuesPresent(String selectName, String[] optionValues)
Assert that given options are present in a select box (by value).
void assertSelectOptionsEqual(String selectName, String[] expectedOptions)
Assert that the display values of a select element's options match a given array of strings.
void assertSelectOptionsNotEqual(String selectName, String[] expectedOptions)
Assert that the display values of a select element's options do not match a given array of strings.
void assertSelectOptionsPresent(String selectName, String[] optionLabels)
Assert that given options are present in a select box (by label).
void assertSelectedOptionEquals(String selectName, String option)
void assertSelectedOptionMatches(String selectName, String regexp)
void assertSelectedOptionValueEquals(String selectName, String value)
Assert that the currently selected value of a select box matches given value.
void assertSelectedOptionValuesEqual(String selectName, String[] values)
Assert that the currently selected value(s) of a select box matches given value(s).
void assertSelectedOptionsEqual(String selectName, String[] labels)
Assert that the currently selected display label(s) of a select box matches given label(s).
void assertSelectedOptionsMatch(String selectName, String[] regexps)
Assert that the currently selected display value(s) of a select box matches a given value(s).
void assertSubmitButtonNotPresent(String buttonName)
Assert that a submit button with a given name is not present.
void assertSubmitButtonNotPresent()
Assert that no submit button is present in the current form.
void assertSubmitButtonPresent(String buttonName, String buttonValue)
Assert that a submit button with a given name and value is present.
void assertSubmitButtonPresent(String buttonName)
Assert that a submit button with a given name is present.
void assertSubmitButtonPresent()
Assert that a submit button is present.
void assertTableEquals(String tableSummaryNameOrId, String[][] expectedCellValues)
Assert that a specific table matches a matrix of supplied text values.
void assertTableEquals(String tableSummaryNameOrId, Table expectedTable)
Assert that a specific table matches an ExpectedTable.
void assertTableMatch(String tableSummaryOrId, String[][] expectedCellValues)
Assert that a specific table matches a matrix of supplied regexps.
void assertTableMatch(String tableSummaryOrId, Table expectedTable)
Assert that a specific table matches an ExpectedTable.
void assertTableNotPresent(String tableSummaryNameOrId)
Assert that a table with a given summary or id value is not present.
void assertTablePresent(String tableSummaryNameOrId)
Assert that a table with a given summary or id value is present.
void assertTableRowCountEquals(String tableSummaryNameOrId, int expectedRowCount)
Assert that the number of rows for a specific table equals expected value.
void assertTableRowsEqual(String tableSummaryNameOrId, int startRow, String[][] expectedTable)
Assert that a range of rows for a specific table matches a matrix of supplied text values.
void assertTableRowsEqual(String tableSummaryNameOrId, int startRow, Table expectedTable)
Assert that a range of rows for a specific table matches a matrix of supplied text values.
void assertTableRowsMatch(String tableSummaryOrId, int startRow, Table expectedTable)
Assert that a range of rows for a specific table matches a matrix of supplied regexps.
void assertTableRowsMatch(String tableSummaryOrId, int startRow, String[][] expectedTable)
Assert that a range of rows for a specific table matches a matrix of supplied regexps.
void assertTextFieldEquals(String formElementName, String expectedValue)
Assert that an input text element with name formElementName has the expectedValue value.
void assertTextInElement(String elementID, String text)
Assert that a given element contains specific text.
void assertTextInTable(String tableSummaryOrId, String[] text)
Assert that a set of text values are all present in a specific table.
void assertTextInTable(String tableSummaryNameOrId, String text)
Assert that supplied text is present in a specific table.
void assertTextNotInElement(String elementID, String text)
void assertTextNotInTable(String tableSummaryNameOrId, String text)
Assert that supplied text is not present in a specific table.
void assertTextNotInTable(String tableSummaryNameOrId, String[] text)
Assert that none of a set of text values are present in a specific table.
void assertTextNotPresent(String text)
Assert that supplied text is not present.
void assertTextPresent(String text)
Assert that supplied text is present.
void assertTitleEquals(String title)
Assert title of current html page in conversation matches an expected value.
void assertTitleEqualsKey(String titleKey)
Assert title of current html page matches the value of a specified web resource.
void assertTitleEqualsKey(String titleKey, Object[] args)
Assert title of current page matches formatted message resource
void assertTitleMatch(String regexp)
Assert title of current html page in conversation matches an expected regexp.
void assertWindowCountEquals(int windowCount)
Assert that the number of opened windows equals given value.
void assertWindowPresent(String windowName)
Assert that a window with the given name is open.
void assertWindowPresent(int windowID)
Assert that a window with the given ID is open.
void assertWindowPresentWithTitle(String title)
Assert that at least one window with the given title is open.
void beginAt(String aRelativeURL)
Begin conversation at a URL absolute or relative to base URL.
void checkCheckbox(String checkBoxName, String value)
Select a specified checkbox.
void checkCheckbox(String checkBoxName)
Select a specified checkbox.
void clickButton(String buttonId)
Click the button with the given id.
void clickButtonWithText(String buttonValueText)
Clicks a button with text of the value attribute.
void clickElementByXPath(String xpath)
Click element with given xpath.
void clickLink(String linkId)
Navigate by selection of a link with given id.
void clickLinkWithExactText(String linkText, int index)
Navigate by selecting Nth link with the exact given text.
void clickLinkWithExactText(String linkText)
Navigate by selection of a link with the exact given text.
void clickLinkWithImage(String imageFileName)
Navigate by selection of a link with a given image.
void clickLinkWithText(String linkText)
Navigate by selection of a link containing given text.
void clickLinkWithText(String linkText, int index)
Navigate by selecting Nth link containing given text.
void clickRadioOption(String radioGroup, String radioOption)
Clicks a radio option.
void closeBrowser()
Close the current conversation.
void closeWindow()
Close the current window.
void dumpCookies()
Print all the cookies to stdout.
void dumpHtml()
This method is deprecated. Use getPageSource()
void dumpHtml(PrintStream stream)
This method is deprecated. Use getPageSource()
void dumpTable(String tableNameOrId)
Dump the table as the 2D array that is used for assertions - for debugging purposes.
void dumpTable(String tableNameOrId, PrintStream stream)
Dump the table as the 2D array that is used for assertions - for debugging purposes.
IJWebUnitDialog getDialog()
This method is deprecated. You should not use plugin specific fonctionality. Please ask for a new core feature instead.
String getElementAttributByXPath(String xpath, String attribut)
Get the attribut value of the gicen element.
String getElementTextByXPath(String xpath)
Get text of the given element.
String getFormElementValue(String formElementName)
This method is deprecated. No replacement.
Image getImage(String imageSrc, String imageAlt)
String getMessage(String key)
Return the value of a web resource based on its key.
String getMessage(String key, Object[] args)
Return the value of a web resource based on its key, using MessageFormat to perform parametric substitution with formatting.
String getPageSource()
Get the source of the HTML page (like in a real browser), or HTTP body for a non HTML content.
String getServeurResponse()
Get the last data sent by the server.
Table getTable(String tableSummaryNameOrId)
TestContext getTestContext()
Provide access to test testContext.
WebTester getTester()
Get internal WebTester.
String getTestingEngineKey()
Gets the Testing Engine Key that is used to find the proper testing engine class (HtmlUnitDialog / SeleniumDialog) for the tests.
void gotoFrame(String frameNameOrId)
Make the given frame active.
void gotoPage(String url)
Go to the given page like if user has typed the URL manually in the browser.
void gotoRootWindow()
Make the root window active.
void gotoWindow(String windowName)
Make a given window active.
void gotoWindow(int windowID)
Make a given window active.
void gotoWindowByTitle(String title)
Make first window with the given title active.
void reset()
Reset the current form using the default reset button.
void runBare()
Clean up unused memory.
void saveAs(File f)
Save the last downloaded page (or file) to the disk.
void selectOption(String selectName, String label)
Select an option with a given display label in a select element.
void selectOptionByValue(String selectName, String value)
Select an option with a given value in a select element.
void selectOptions(String selectName, String[] labels)
Select options with given display labels in a select element.
void selectOptionsByValues(String selectName, String[] values)
Select options with given values in a select element.
void setDialog(IJWebUnitDialog aIJWebUnitDialog)
Set the testing engine.
void setExpectedJavaScriptAlert(String message)
Tell that the given alert boxe is expected.
void setExpectedJavaScriptAlert(String[] messages)
Tell that the given alert boxes are expected in the given order.
void setExpectedJavaScriptConfirm(String[] messages, boolean[] actions)
Tell that the given confirm boxes are expected in the given order.
void setExpectedJavaScriptConfirm(String message, boolean action)
Tell that the given confirm boxe is expected.
void setExpectedJavaScriptPrompt(String[] messages, String[] inputs)
Tell that the given prompt boxes are expected in the given order.
void setExpectedJavaScriptPrompt(String message, String input)
Tell that the given prompt boxe is expected.
void setFormElement(String formElementName, String value)
This method is deprecated. use setTextField or other methods
void setScriptingEnabled(boolean value)
Enable or disable Javascript support
void setTestContext(TestContext aTestContext)
Allows setting an external test testContext class that might be extended from TestContext.
void setTester(WebTester tester)
void setTestingEngineKey(String testingEngineKey)
Set the Testing Engine that you want to use for the tests based on the Testing Engine Key.
void setTextField(String inputName, String value)
Set the value of a text or password input field.
void setWorkingForm(int index)
Begin interaction with a specified form.
void setWorkingForm(String nameOrId)
Begin interaction with a specified form.
void setWorkingForm(String nameOrId, int index)
Begin interaction with a specified form.
void submit(String buttonName, String buttonValue)
Submit the form by pressing the named button with the given value (label).
void submit(String buttonName)
Submit form by pressing named button.
void submit()
Submit form - default submit button will be used (unnamed submit button, or named button if there is only one on the form.
void uncheckCheckbox(String checkBoxName)
Deselect a specified checkbox.
void uncheckCheckbox(String checkBoxName, String value)
Deselect a specified checkbox.
void wrapWithPageSourceOnError(Runnable runnable)
For use on those few occasions when the exception might be recoverable, but we still want to see what went wrong.
Protected Methods
void removeThreadLocal()
void tearDown()
[Expand]
Inherited Methods
From class junit.framework.TestCase
From class junit.framework.Assert
From class java.lang.Object
From interface junit.framework.Test

Public Constructors

public ThreadLocalWebTestCase (String name)

public ThreadLocalWebTestCase ()

Public Methods

public void assertButtonNotPresent (String buttonId)

Assert that a button with a given id is not present in the current window.

public void assertButtonNotPresentWithText (String text)

Assert that a button with a given text is not present in the current window.

Parameters
text Text representation of button content.

public void assertButtonPresent (String buttonId)

Assert that a button with a given id is present in the current window.
A button can be the following HTML elements:

  • button input
  • button button

public void assertButtonPresentWithText (String text)

Assert that a button with a given text is present in the current window.

Parameters
text Text representation of button content.

public void assertCheckboxNotPresent (String checkboxName, String checkboxValue)

Assert that a given checkbox is not present.

Parameters
checkboxName checkbox name.
checkboxValue checkbox value attribut.

public void assertCheckboxNotPresent (String checkboxName)

Assert that a form checkbox with a given name is not present.

Parameters
checkboxName checkbox name.

public void assertCheckboxNotSelected (String checkBoxName, String checkBoxValue)

Assert that a specific checkbox is not selected.

public void assertCheckboxNotSelected (String checkBoxName)

Assert that a specific checkbox is not selected.

public void assertCheckboxPresent (String checkboxName, String checkboxValue)

Assert that a given checkbox is present.

Parameters
checkboxName checkbox name attribut.
checkboxValue checkbox value attribut.

public void assertCheckboxPresent (String checkboxName)

Assert that a form checkbox with a given name is present.

Parameters
checkboxName checkbox name.

public void assertCheckboxSelected (String checkBoxName, String checkBoxValue)

Assert that a specific checkbox is selected.

public void assertCheckboxSelected (String checkBoxName)

Assert that a specific checkbox is selected.

public void assertCookiePresent (String cookieName)

Checks to see if a cookie is present in the response.

Parameters
cookieName The cookie name

public void assertCookieValueEquals (String cookieName, String expectedValue)

Check to see if a cookie has the given value.

Parameters
cookieName The cookie name
expectedValue The cookie value

public void assertCookieValueMatch (String cookieName, String regexp)

Check to see if a cookie value match the given regexp.

Parameters
cookieName The cookie name
regexp The regexp

public void assertDownloadedFileEquals (URL expected)

Download the current page (or file) and compare it with the given file.

Parameters
expected Expected file URL.

public void assertElementNotPresent (String anID)

Assert that an element with a given id is not present.

Parameters
anID element id to test for.

public void assertElementNotPresentByXPath (String xpath)

Assert that an element with a given xpath is not present.

Parameters
xpath element xpath to test for.

public void assertElementPresent (String anID)

Assert that an element with a given id is present.

Parameters
anID element id to test for.

public void assertElementPresentByXPath (String xpath)

Assert that an element with a given xpath is present.

Parameters
xpath element xpath to test for.

public void assertFormElementEmpty (String formElementName)

This method is deprecated.
No replacement.

Assert that a form element had no value / is empty.

public void assertFormElementEquals (String formElementName, String expectedValue)

This method is deprecated.
No replacement.

Assert that a specific form element has an expected value. Can be used to check hidden input.

public void assertFormElementMatch (String formElementName, String regexp)

This method is deprecated.
No replacement.

Assert that a specific form element matches an expected regexp.

public void assertFormElementNotPresent (String formElementName)

Assert that a form input element with a given name is not present.

public void assertFormElementPresent (String formElementName)

Assert that a form input element with a given name is present.

public void assertFormNotPresent ()

Assert that there is not a form present.

public void assertFormNotPresent (String nameOrID)

Assert that there is not a form with the specified name or id present.

public void assertFormPresent (String nameOrID)

Assert that there is a form with the specified name or id present.

public void assertFormPresent ()

Assert that there is a form present.

public void assertFramePresent (String frameNameOrId)

Assert that a frame with the given name or ID is present.

Parameters
frameNameOrId Name or ID of the frame. ID is checked first.

public void assertHiddenFieldPresent (String formElementName, String expectedValue)

Assert that an input hidden element with name formElementName has the expectedValue value.

Parameters
formElementName the value of the name attribute of the element
expectedValue the expected value of the given input element

public void assertImagePresent (String imageSrc, String imageAlt)

public void assertImageValid (String imageSrc, String imageAlt)

See Also

public void assertImageValidAndStore (String imageSrc, String imageAlt, File out)

Asserts that the image with the given src and alt attribute values exist in the page and is an actual reachable image, then saves it as png with the given file name.

Parameters
imageSrc as it appears in the html page, i.e. relative to the current page.

public void assertKeyInTable (String tableSummaryOrId, String key, Object[] args)

Assert that the value of a given web resource is present in a specific table.

Parameters
tableSummaryOrId summary or id attribute value of table
key web resource name

public void assertKeyInTable (String tableSummaryOrId, String key)

Assert that the value of a given web resource is present in a specific table.

Parameters
tableSummaryOrId summary or id attribute value of table
key web resource name

public void assertKeyNotInTable (String tableSummaryOrId, String key)

Assert that the value of a given web resource is not present in a specific table.

Parameters
tableSummaryOrId summary, name or id attribute value of table
key web resource name

public void assertKeyNotPresent (String key)

Assert that a web resource's value is not present.

Parameters
key web resource name

public void assertKeyNotPresent (String key, Object[] args)

Assert that a web resource's formatted value is not present.

Parameters
key web resource name

public void assertKeyPresent (String key)

Assert that a web resource's value is present.

Parameters
key web resource name

public void assertKeyPresent (String key, Object[] args)

Assert that a web resource's value (with formatting) is present

public void assertKeysInTable (String tableSummaryOrId, String[] keys)

Assert that the values of a set of web resources are all present in a specific table.

Parameters
tableSummaryOrId summary, name or id attribute value of table
keys Array of web resource names.

public void assertKeysInTable (String tableSummaryOrId, String[] keys, Object[][] args)

Assert that the values of a set of web resources are all present in a specific table.

Parameters
tableSummaryOrId summary or id attribute value of table
keys Array of web resource names.

public void assertLinkNotPresent (String linkId)

Assert that no link with the given id is present in the response.

public void assertLinkNotPresentWithExactText (String linkText, int index)

Assert that no link containing the Exact text is present.

Parameters
index The 0-based index, when more than one link with the same text is expected.

public void assertLinkNotPresentWithExactText (String linkText)

Assert that no link containing the Exact text is present.

public void assertLinkNotPresentWithImage (String imageFileName)

Assert that a link containing a specified image is not present.

Parameters
imageFileName A suffix of the image's filename; for example, to match "images/my_icon.png", you could just pass in "my_icon.png".

public void assertLinkNotPresentWithText (String linkText)

Assert that no link containing the supplied text is present.

public void assertLinkNotPresentWithText (String linkText, int index)

Assert that no link containing the supplied text is present.

Parameters
index The 0-based index, when more than one link with the same text is expected.

public void assertLinkPresent (String linkId)

Assert that a link with a given id is present in the response.

public void assertLinkPresentWithExactText (String linkText)

Assert that a link containing the Exact text is present.

public void assertLinkPresentWithExactText (String linkText, int index)

Assert that a link containing the Exact text is present.

Parameters
index The 0-based index, when more than one link with the same text is expected.

public void assertLinkPresentWithImage (String imageFileName)

Assert that a link containing a specified image is present.

Parameters
imageFileName A suffix of the image's filename; for example, to match "images/my_icon.png", you could just pass in "my_icon.png".

public void assertLinkPresentWithText (String linkText, int index)

Assert that a link containing the supplied text is present.

Parameters
index The 0-based index, when more than one link with the same text is expected.

public void assertLinkPresentWithText (String linkText)

Assert that a link containing the supplied text is present.

public void assertMatch (String regexp)

Assert that supplied regexp is matched.

public void assertMatchInElement (String elementID, String regexp)

Assert that a given element matches a specific regexp.

Parameters
elementID id of element to be inspected.
regexp to match.

public void assertMatchInTable (String tableSummaryOrId, String[] regexp)

Assert that a set of regexp values are all matched in a specific table.

Parameters
tableSummaryOrId summary, name or id attribute value of table
regexp Array of expected regexps to match.

public void assertMatchInTable (String tableSummaryNameOrId, String regexp)

Assert that supplied regexp is matched in a specific table.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table

public void assertNoMatch (String regexp)

Assert that supplied regexp is not present.

public void assertNoMatchInElement (String elementID, String regexp)

Assert that a given element does not match a specific regexp.

Parameters
elementID id of element to be inspected.
regexp to match.

public void assertNoMatchInTable (String tableSummaryNameOrId, String regexp)

Assert that supplied regexp is not present in a specific table.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table
regexp regular expression string expected not to match data in any table cell

public void assertNoMatchInTable (String tableSummaryNameOrId, String[] regexp)

Assert that none of a set of regexp values are present in a specific table.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table
regexp Array of text values

public void assertRadioOptionNotPresent (String name, String radioOption)

Assert that a specific option is not present in a radio group.

Parameters
name radio group name.
radioOption option to test for.

public void assertRadioOptionNotSelected (String name, String radioOption)

Assert that a specific option is not selected in a radio group.

Parameters
name radio group name.
radioOption option to test for selection.

public void assertRadioOptionPresent (String name, String radioOption)

Assert that a specific option is present in a radio group.

Parameters
name radio group name.
radioOption option to test for.

public void assertRadioOptionSelected (String name, String radioOption)

Assert that a specific option is selected in a radio group.

Parameters
name radio group name.
radioOption option to test for selection.

public void assertResetButtonNotPresent ()

Assert that no reset button is present in the current form.
A reset button can be the following HTML elements:

  • reset input
  • reset button

public void assertResetButtonNotPresent (String buttonName)

Assert that a reset button with a given name is not present.
A reset button can be the following HTML elements:

  • reset input
  • reset button

public void assertResetButtonPresent ()

Assert that a reset button is present.
A reset button can be the following HTML elements:

  • reset input
  • reset button

public void assertResetButtonPresent (String buttonName)

Assert that a reset button with a given name is present.
A reset button can be the following HTML elements:

  • reset input
  • reset button

public void assertSelectOptionNotPresent (String selectName, String optionLabel)

Assert that a specific option is not present in a select box.

Parameters
selectName name of the select element.
optionLabel option label.

public void assertSelectOptionPresent (String selectName, String optionLabel)

Assert that a specific option is present in a select box (by label).

Parameters
selectName name of the select element.
optionLabel option label.

public void assertSelectOptionValueNotPresent (String selectName, String optionValue)

public void assertSelectOptionValuePresent (String selectName, String optionValue)

Assert that a specific option is present in a select box (by value).

Parameters
selectName name of the select element.
optionValue option value.

public void assertSelectOptionValuesEqual (String selectName, String[] expectedValues)

Assert that the values of a select element's options match a given array of strings.

Parameters
selectName name of the select element.
expectedValues expected values for the select box.

public void assertSelectOptionValuesNotEqual (String selectName, String[] optionValues)

Assert that the values of a select element's options do not match a given array of strings.

Parameters
selectName name of the select element.
optionValues expected values for the select box.

public void assertSelectOptionValuesPresent (String selectName, String[] optionValues)

Assert that given options are present in a select box (by value).

Parameters
selectName name of the select element.
optionValues option labels.

public void assertSelectOptionsEqual (String selectName, String[] expectedOptions)

Assert that the display values of a select element's options match a given array of strings.

Parameters
selectName name of the select element.
expectedOptions expected labels for the select box.

public void assertSelectOptionsNotEqual (String selectName, String[] expectedOptions)

Assert that the display values of a select element's options do not match a given array of strings.

Parameters
selectName name of the select element.
expectedOptions expected display values for the select box.

public void assertSelectOptionsPresent (String selectName, String[] optionLabels)

Assert that given options are present in a select box (by label).

Parameters
selectName name of the select element.
optionLabels option labels.

public void assertSelectedOptionEquals (String selectName, String option)

public void assertSelectedOptionMatches (String selectName, String regexp)

public void assertSelectedOptionValueEquals (String selectName, String value)

Assert that the currently selected value of a select box matches given value.

Parameters
selectName name of the select element.
value expected value of the selected option.

public void assertSelectedOptionValuesEqual (String selectName, String[] values)

Assert that the currently selected value(s) of a select box matches given value(s).

Parameters
selectName name of the select element.
values expected value(s) of the selected option.

public void assertSelectedOptionsEqual (String selectName, String[] labels)

Assert that the currently selected display label(s) of a select box matches given label(s).

Parameters
selectName name of the select element.
labels expected display label(s) of the selected option.

public void assertSelectedOptionsMatch (String selectName, String[] regexps)

Assert that the currently selected display value(s) of a select box matches a given value(s).

Parameters
selectName name of the select element.
regexps expected display value of the selected option.

public void assertSubmitButtonNotPresent (String buttonName)

Assert that a submit button with a given name is not present.
A submit button can be the following HTML elements:

  • submit input
  • image input
  • submit button

public void assertSubmitButtonNotPresent ()

Assert that no submit button is present in the current form.
A submit button can be the following HTML elements:

  • submit input
  • image input
  • submit button

public void assertSubmitButtonPresent (String buttonName, String buttonValue)

Assert that a submit button with a given name and value is present.
A submit button can be the following HTML elements:

  • submit input
  • image input
  • submit button

public void assertSubmitButtonPresent (String buttonName)

Assert that a submit button with a given name is present.
A submit button can be the following HTML elements:

  • submit input
  • image input
  • submit button

public void assertSubmitButtonPresent ()

Assert that a submit button is present.
A submit button can be the following HTML elements:

  • submit input
  • image input
  • submit button

public void assertTableEquals (String tableSummaryNameOrId, String[][] expectedCellValues)

Assert that a specific table matches a matrix of supplied text values.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table
expectedCellValues double dimensional array of expected values

public void assertTableEquals (String tableSummaryNameOrId, Table expectedTable)

Assert that a specific table matches an ExpectedTable.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table
expectedTable represents expected values (colspan supported).

public void assertTableMatch (String tableSummaryOrId, String[][] expectedCellValues)

Assert that a specific table matches a matrix of supplied regexps.

Parameters
tableSummaryOrId summary or id attribute value of table
expectedCellValues double dimensional array of expected regexps

public void assertTableMatch (String tableSummaryOrId, Table expectedTable)

Assert that a specific table matches an ExpectedTable.

Parameters
tableSummaryOrId summary or id attribute value of table
expectedTable represents expected regexps (colspan supported).

public void assertTableNotPresent (String tableSummaryNameOrId)

Assert that a table with a given summary or id value is not present.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table

public void assertTablePresent (String tableSummaryNameOrId)

Assert that a table with a given summary or id value is present.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table

public void assertTableRowCountEquals (String tableSummaryNameOrId, int expectedRowCount)

Assert that the number of rows for a specific table equals expected value.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table
expectedRowCount expected row count.

public void assertTableRowsEqual (String tableSummaryNameOrId, int startRow, String[][] expectedTable)

Assert that a range of rows for a specific table matches a matrix of supplied text values.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table
startRow index of start row for comparison
expectedTable represents expected values (colspan and rowspan supported).

public void assertTableRowsEqual (String tableSummaryNameOrId, int startRow, Table expectedTable)

Assert that a range of rows for a specific table matches a matrix of supplied text values.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table
startRow index of start row for comparison
expectedTable represents expected values (colspan and rowspan supported).

public void assertTableRowsMatch (String tableSummaryOrId, int startRow, Table expectedTable)

Assert that a range of rows for a specific table matches a matrix of supplied regexps.

Parameters
tableSummaryOrId summary or id attribute value of table
startRow index of start row for comparison
expectedTable represents expected regexps (colspan and rowspan supported).

public void assertTableRowsMatch (String tableSummaryOrId, int startRow, String[][] expectedTable)

Assert that a range of rows for a specific table matches a matrix of supplied regexps.

Parameters
tableSummaryOrId summary or id attribute value of table
startRow index of start row for comparison
expectedTable represents expected regexps (colspan and rowspan not supported).

public void assertTextFieldEquals (String formElementName, String expectedValue)

Assert that an input text element with name formElementName has the expectedValue value.

Parameters
formElementName the value of the name attribute of the element
expectedValue the expected value of the given input element

public void assertTextInElement (String elementID, String text)

Assert that a given element contains specific text.

Parameters
elementID id of element to be inspected.
text to check for.

public void assertTextInTable (String tableSummaryOrId, String[] text)

Assert that a set of text values are all present in a specific table.

Parameters
tableSummaryOrId summary, name or id attribute value of table
text Array of expected text values.

public void assertTextInTable (String tableSummaryNameOrId, String text)

Assert that supplied text is present in a specific table.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table

public void assertTextNotInElement (String elementID, String text)

public void assertTextNotInTable (String tableSummaryNameOrId, String text)

Assert that supplied text is not present in a specific table.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table

public void assertTextNotInTable (String tableSummaryNameOrId, String[] text)

Assert that none of a set of text values are present in a specific table.

Parameters
tableSummaryNameOrId summary, name or id attribute value of table
text Array of text values

public void assertTextNotPresent (String text)

Assert that supplied text is not present.

public void assertTextPresent (String text)

Assert that supplied text is present.

public void assertTitleEquals (String title)

Assert title of current html page in conversation matches an expected value.

Parameters
title expected title value

public void assertTitleEqualsKey (String titleKey)

Assert title of current html page matches the value of a specified web resource.

Parameters
titleKey web resource key for title

public void assertTitleEqualsKey (String titleKey, Object[] args)

Assert title of current page matches formatted message resource

public void assertTitleMatch (String regexp)

Assert title of current html page in conversation matches an expected regexp.

Parameters
regexp expected title regexp

public void assertWindowCountEquals (int windowCount)

Assert that the number of opened windows equals given value.

Parameters
windowCount Window count

public void assertWindowPresent (String windowName)

Assert that a window with the given name is open.

public void assertWindowPresent (int windowID)

Assert that a window with the given ID is open.

Parameters
windowID Javascript window ID.

public void assertWindowPresentWithTitle (String title)

Assert that at least one window with the given title is open.

public void beginAt (String aRelativeURL)

Begin conversation at a URL absolute or relative to base URL. Use getTestContext().setBaseUrl(String) to define base URL. Absolute URL should start with "http://", "https://" or "www.".

Parameters
aRelativeURL absolute or relative URL (relative to base URL).
Throws
TestingEngineResponseException If something bad happend (404)

public void checkCheckbox (String checkBoxName, String value)

Select a specified checkbox. If the checkbox is already checked then the checkbox will stay checked.

Parameters
checkBoxName name of checkbox to be selected.
value value of checkbox to be selected.

public void checkCheckbox (String checkBoxName)

Select a specified checkbox. If the checkbox is already checked then the checkbox will stay checked.

Parameters
checkBoxName name of checkbox to be selected.

public void clickButton (String buttonId)

Click the button with the given id.

Parameters
buttonId Button ID attribut value.

public void clickButtonWithText (String buttonValueText)

Clicks a button with text of the value attribute.

Parameters
buttonValueText The text of the button (contents of the value attribute).

public void clickElementByXPath (String xpath)

Click element with given xpath.

Parameters
xpath xpath of the element.

public void clickLink (String linkId)

Navigate by selection of a link with given id.

Parameters
linkId id of link

public void clickLinkWithExactText (String linkText, int index)

Navigate by selecting Nth link with the exact given text.

Parameters
linkText Text of the link.
index The 0-based index, when more than one link with the same text is expected.

public void clickLinkWithExactText (String linkText)

Navigate by selection of a link with the exact given text.

Parameters
linkText Text of the link.

public void clickLinkWithImage (String imageFileName)

Navigate by selection of a link with a given image.

Parameters
imageFileName A suffix of the image's filename; for example, to match "images/my_icon.png", you could just pass in "my_icon.png".

public void clickLinkWithText (String linkText)

Navigate by selection of a link containing given text.

Parameters
linkText Text in the link.

public void clickLinkWithText (String linkText, int index)

Navigate by selecting Nth link containing given text.

Parameters
linkText Text in the link.
index The 0-based index, when more than one link with the same text is expected.

public void clickRadioOption (String radioGroup, String radioOption)

Clicks a radio option. Asserts that the radio option exists first. *

Parameters
radioGroup name of the radio group.
radioOption value of the option to check for.

public void closeBrowser ()

Close the current conversation.

public void closeWindow ()

Close the current window.

public void dumpCookies ()

Print all the cookies to stdout.

public void dumpHtml ()

This method is deprecated.
Use getPageSource()

Dump html of current response to System.out - for debugging purposes.

public void dumpHtml (PrintStream stream)

This method is deprecated.
Use getPageSource()

Dump html of current response to a specified stream - for debugging purposes.

public void dumpTable (String tableNameOrId)

Dump the table as the 2D array that is used for assertions - for debugging purposes.

public void dumpTable (String tableNameOrId, PrintStream stream)

Dump the table as the 2D array that is used for assertions - for debugging purposes.

public IJWebUnitDialog getDialog ()

This method is deprecated.
You should not use plugin specific fonctionality. Please ask for a new core feature instead.

Provides access to the testing engine for subclasses - in case functionality not yet wrapped is required by a test.

If the dialog is not explicitly set the jWebUnit framework will default to using the orignal testing engine, which is, htmlunit.
Returns
  • IJWebUnitDialog instance used to wrapper htmlunit conversation.

public String getElementAttributByXPath (String xpath, String attribut)

Get the attribut value of the gicen element. For example, if you have img src="bla.gif" alt="toto", getElementAttributByXPath("//img[@src='bla.gif']", "alt") returns "toto"

Parameters
xpath XPath of the element.
attribut Name of the attribut.
Returns
  • The value of the attribut.

public String getElementTextByXPath (String xpath)

Get text of the given element.

Parameters
xpath xpath of the element.

public String getFormElementValue (String formElementName)

This method is deprecated.
No replacement.

public Image getImage (String imageSrc, String imageAlt)

See Also

public String getMessage (String key)

Return the value of a web resource based on its key. This translates to a property file lookup with the locale based on the current TestContext.

Parameters
key name of the web resource.
Returns
  • value of the web resource, encoded according to TestContext.

public String getMessage (String key, Object[] args)

Return the value of a web resource based on its key, using MessageFormat to perform parametric substitution with formatting.

Parameters
key name of the web resource.
args array of arguments to be formatted into message
Returns
  • value of the web resource after formatting
See Also

public String getPageSource ()

Get the source of the HTML page (like in a real browser), or HTTP body for a non HTML content.

Returns
  • The HTML content.

public String getServeurResponse ()

Get the last data sent by the server.

Returns
  • HTTP server response.

public Table getTable (String tableSummaryNameOrId)

Returns
  • Object that represent a html table in a way independent from plugin.

public TestContext getTestContext ()

Provide access to test testContext.

Returns
  • TestContext

public WebTester getTester ()

Get internal WebTester.

public String getTestingEngineKey ()

Gets the Testing Engine Key that is used to find the proper testing engine class (HtmlUnitDialog / SeleniumDialog) for the tests.

Returns
  • Returns the testingEngineKey.

public void gotoFrame (String frameNameOrId)

Make the given frame active.

Parameters
frameNameOrId Name or ID of the frame. ID is checked first.

public void gotoPage (String url)

Go to the given page like if user has typed the URL manually in the browser. Use getTestContext().setBaseUrl(String) to define base URL. Absolute URL should start with "http://", "https://" or "www.".

Parameters
url absolute or relative URL (relative to base URL).
Throws
TestingEngineResponseException If something bad happend (404)

public void gotoRootWindow ()

Make the root window active.

public void gotoWindow (String windowName)

Make a given window active.

Parameters
windowName Name of the window.

public void gotoWindow (int windowID)

Make a given window active.

Parameters
windowID Javascript ID of the window

public void gotoWindowByTitle (String title)

Make first window with the given title active.

Parameters
title Title of the window.

public void reset ()

Reset the current form using the default reset button. See setWorkingForm(int)for an explanation of how the current form is established.

public void runBare ()

Clean up unused memory. Using setUp and tearDown is not an option for this requires the subclasses of this class to call the respective super methods. Also wrap any exceptions and include the URL and HTML for the current page.

Throws
Throwable

public void saveAs (File f)

Save the last downloaded page (or file) to the disk.

Parameters
f The file name.

public void selectOption (String selectName, String label)

Select an option with a given display label in a select element.

Parameters
selectName name of select element.
label label of option to be selected.

public void selectOptionByValue (String selectName, String value)

Select an option with a given value in a select element.

Parameters
selectName name of select element.
value values of options to be selected.

public void selectOptions (String selectName, String[] labels)

Select options with given display labels in a select element.

Parameters
selectName name of select element.
labels labels of options to be selected.

public void selectOptionsByValues (String selectName, String[] values)

Select options with given values in a select element.

Parameters
selectName name of select element.
values values of options to be selected.

public void setDialog (IJWebUnitDialog aIJWebUnitDialog)

Set the testing engine.

Parameters
aIJWebUnitDialog Testing engine.

public void setExpectedJavaScriptAlert (String message)

Tell that the given alert boxe is expected.

Parameters
message Message in the alert.

public void setExpectedJavaScriptAlert (String[] messages)

Tell that the given alert boxes are expected in the given order.

Parameters
messages Messages in the alerts.

public void setExpectedJavaScriptConfirm (String[] messages, boolean[] actions)

Tell that the given confirm boxes are expected in the given order.

Parameters
messages Messages in the confirms.
actions Whether we should click on "OK" (true) or "Cancel" (false)

public void setExpectedJavaScriptConfirm (String message, boolean action)

Tell that the given confirm boxe is expected.

Parameters
message Message in the confirm.
action Whether we should click on "OK" (true) or "Cancel" (false)

public void setExpectedJavaScriptPrompt (String[] messages, String[] inputs)

Tell that the given prompt boxes are expected in the given order.

Parameters
messages Messages in the prompts.
inputs What we should put in the prompt (null if user press Cancel)

public void setExpectedJavaScriptPrompt (String message, String input)

Tell that the given prompt boxe is expected.

Parameters
message Message in the prompt.
input What we should put in the prompt (null if user press Cancel)

public void setFormElement (String formElementName, String value)

This method is deprecated.
use setTextField or other methods

Set the value of a form input element.

Parameters
formElementName name of form element.

public void setScriptingEnabled (boolean value)

Enable or disable Javascript support

public void setTestContext (TestContext aTestContext)

Allows setting an external test testContext class that might be extended from TestContext. Example: setTestContext(new CompanyATestContext());

CompanyATestContext extends TestContext.

public void setTester (WebTester tester)

public void setTestingEngineKey (String testingEngineKey)

Set the Testing Engine that you want to use for the tests based on the Testing Engine Key.

Parameters
testingEngineKey The testingEngineKey to set.
See Also
  • net.sourceforge.jwebunit.util.TestingEngineRegistry

public void setTextField (String inputName, String value)

Set the value of a text or password input field.

Parameters
inputName name of form element.
value value to set.

public void setWorkingForm (int index)

Begin interaction with a specified form. If form interaction methods are called without explicitly calling this method first, jWebUnit will attempt to determine itself which form is being manipulated.

It is not necessary to call this method if their is only one form on the current page.
Parameters
index 0-based index of the form to work with.

public void setWorkingForm (String nameOrId)

Begin interaction with a specified form. If form interaction methods are called without explicitly calling this method first, jWebUnit will attempt to determine itself which form is being manipulated.

It is not necessary to call this method if their is only one form on the current page.
Parameters
nameOrId name or id of the form to work with.

public void setWorkingForm (String nameOrId, int index)

Begin interaction with a specified form. If form interaction methods are called without explicitly calling this method first, jWebUnit will attempt to determine itself which form is being manipulated.

It is not necessary to call this method if their is only one form on the current page.
Parameters
nameOrId name or id of the form to work with.
index The 0-based index, when more than one form with the same name is expected.

public void submit (String buttonName, String buttonValue)

Submit the form by pressing the named button with the given value (label). Useful if you have more than one submit button with same name.

Parameters
buttonName Submit button name attribut value.
buttonValue Submit button value attribut value.

public void submit (String buttonName)

Submit form by pressing named button.

Parameters
buttonName Submit button name attribut value.

public void submit ()

Submit form - default submit button will be used (unnamed submit button, or named button if there is only one on the form.

public void uncheckCheckbox (String checkBoxName)

Deselect a specified checkbox. If the checkbox is already unchecked then the checkbox will stay unchecked.

Parameters
checkBoxName name of checkbox to be deselected.

public void uncheckCheckbox (String checkBoxName, String value)

Deselect a specified checkbox. If the checkbox is already unchecked then the checkbox will stay unchecked.

Parameters
checkBoxName name of checkbox to be deselected.
value value of checkbox to be deselected.

public void wrapWithPageSourceOnError (Runnable runnable)

For use on those few occasions when the exception might be recoverable, but we still want to see what went wrong.

Parameters
runnable The original error object
Throws
AssertionFailedError A new error with the old one wrapped as a cause

Protected Methods

protected void removeThreadLocal ()

protected void tearDown ()

Throws
Exception