public class WebTester extends Object
Constructor and Description |
---|
WebTester() |
Modifier and Type | Method and Description |
---|---|
protected boolean |
areFilesEqual(URL f1,
URL f2) |
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)
Assert that a form checkbox with a given name is not present.
|
void |
assertCheckboxNotPresent(String checkboxName,
String checkboxValue)
Assert that a given checkbox is not present.
|
void |
assertCheckboxNotSelected(String checkBoxName)
Assert that a specific checkbox is not selected.
|
void |
assertCheckboxNotSelected(String checkBoxName,
String checkBoxValue)
Assert that a specific checkbox is not selected.
|
void |
assertCheckboxPresent(String checkboxName)
Assert that a form checkbox with a given name is present.
|
void |
assertCheckboxPresent(String checkboxName,
String checkboxValue)
Assert that a given checkbox is present.
|
void |
assertCheckboxSelected(String checkBoxName)
Assert that a specific checkbox is selected.
|
void |
assertCheckboxSelected(String checkBoxName,
String checkBoxValue)
Assert that a specific checkbox is selected.
|
void |
assertCommentNotPresent(String comment)
Assert that a comment is not present.
|
void |
assertCommentPresent(String comment)
Assert that a comment is present.
|
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)
Deprecated.
use an explicit testing method, e.g.
setTextField(String, String) or setHiddenField(String, String) |
void |
assertFormElementEquals(String formElementName,
String expectedValue)
Deprecated.
use an explicit testing method, e.g.
assertTextFieldEquals(String, String) |
void |
assertFormElementMatch(String formElementName,
String regexp)
Assert that a specific form element matches an expected regexp.
|
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()
Assert that there is a form present.
|
void |
assertFormPresent(String nameOrID)
Assert that there is a form with the specified name or id present.
|
void |
assertFormPresent(String nameOrID,
int index)
Assert that there is a form with the specified name or id and the given index present.
|
void |
assertFramePresent(String frameNameOrId)
Assert that a frame with the given name or ID is present.
|
void |
assertHeaderEquals(String name,
String value)
Assert a header is equal to a particular value.
|
void |
assertHeaderMatches(String name,
String regexp)
Assert a header matches a particular pattern.
|
void |
assertHeaderNotPresent(String name)
Assert a header is NOT present.
|
void |
assertHeaderPresent(String name)
Assert a header 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)
Assert there is at least one image in the page with given src and (optional) alt attributes.
|
void |
assertImagePresentPartial(String partialImageSrc,
String partialImageAlt)
Assert there is at least one image in the page with given partial src and (optional) partial alt attributes.
|
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)
Assert that the value of a given web resource is present in a specific table.
|
void |
assertKeyInTable(String tableSummaryOrId,
String key,
Object[] args)
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 |
assertLabeledFieldEquals(String id,
String fieldText)
Assert that a labeled field exists (for the given ID) and the
field that it labels equals the given text
|
void |
assertLabelMatches(String regexp)
Assert a label exists.
|
void |
assertLabelPresent(String id)
Assert a label for a given ID exists.
|
void |
assertLinkNotPresent(String linkId)
Assert that no link with the given id is present in the response.
|
void |
assertLinkNotPresentWithExactText(String linkText)
Assert that no link containing the Exact text is present.
|
void |
assertLinkNotPresentWithExactText(String linkText,
int index)
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 |
assertLinkNotPresentWithImage(String imageFileName,
int index)
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 |
assertLinkPresentWithImage(String imageFileName,
int index)
Assert that a link containing a specified image is present.
|
void |
assertLinkPresentWithText(String linkText)
Assert that a link containing the supplied text is present.
|
void |
assertLinkPresentWithText(String linkText,
int index)
Assert that a link containing the supplied text is present.
|
void |
assertMatch(String regexp)
Assert that supplied regexp is matched in the text of a page.
|
void |
assertMatch(String regexp,
String text)
Assert a given string matches a given regular expression.
|
void |
assertMatch(String message,
String regexp,
String text)
Assert a given string matches a given regular expression.
|
void |
assertMatchInElement(String elementID,
String regexp)
Assert that a given element matches a specific regexp.
|
void |
assertMatchInTable(String tableSummaryNameOrId,
String regexp)
Assert that supplied regexp is matched in a specific table.
|
void |
assertMatchInTable(String tableSummaryOrId,
String[] regexp)
Assert that a set of regexp values are all 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 |
assertNotMatch(String regexp,
String text)
Assert a given string does not match a given regular expression.
|
void |
assertNotMatch(String message,
String regexp,
String text)
Assert a given string does not match a given regular expression.
|
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 |
assertResponseCode(int status)
Assert that the page response has a particular code.
|
void |
assertResponseCodeBetween(int lower,
int higher)
Assert that the page response has a particular code between lower and higher
(
lower <= status <= higher ). |
void |
assertSelectedOptionEquals(String selectName,
int index,
String option)
Assert that the label of the current selected option matches
the provided value in the Nth select element with the specified name.
|
void |
assertSelectedOptionEquals(String selectName,
String optionLabel)
Assert that the label of the current selected option matches
the provided value.
|
void |
assertSelectedOptionMatches(String selectName,
int index,
String regexp)
Assert that the label of the current selected option matches
the provided regular expression in the Nth select element with the specified name.
|
void |
assertSelectedOptionMatches(String selectName,
String regexp)
Assert that the label of the current selected option matches
the provided regular expression value.
|
void |
assertSelectedOptionsEqual(String selectName,
int index,
String[] labels)
Assert that the currently selected display label(s) of a select box matches given label(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,
int index,
String[] regexps)
Assert that the currently selected display value(s) of a select box matches a given value(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 |
assertSelectedOptionValueEquals(String selectName,
int index,
String value)
Assert that the currently selected value of a select box matches given value.
|
void |
assertSelectedOptionValueEquals(String selectName,
String value)
Assert that the currently selected value of a select box matches given value.
|
void |
assertSelectedOptionValuesEqual(String selectName,
int index,
String[] values)
Assert that the currently selected value(s) of the Nth
select box with the specified name matches given value(s).
|
void |
assertSelectedOptionValuesEqual(String selectName,
String[] values)
Assert that the currently selected value(s) of a select box matches given value(s).
|
void |
assertSelectOptionNotPresent(String selectName,
int index,
String optionLabel)
Assert that a specific option is not present in a select box.
|
void |
assertSelectOptionNotPresent(String selectName,
String optionLabel)
Assert that a specific option is not present in a select box.
|
void |
assertSelectOptionPresent(String selectName,
int index,
String optionLabel)
Assert that a specific option is present in the Nth select box (by label).
|
void |
assertSelectOptionPresent(String selectName,
String optionLabel)
Assert that a specific option is present in a select box (by label).
|
void |
assertSelectOptionsEqual(String selectName,
int index,
String[] expectedOptions)
Assert that the display values of
the Nth select element's options match a given array of strings.
|
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,
int index,
String[] expectedOptions)
Assert that the display values of the Nth select element's
options do not 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,
int index,
String[] optionLabels)
Assert that given options are present in the Nth select box (by label).
|
void |
assertSelectOptionsPresent(String selectName,
String[] optionLabels)
Assert that given options are present in a select box (by label).
|
void |
assertSelectOptionValueNotPresent(String selectName,
int index,
String optionValue)
Assert that a specific option value is not present in a select box.
|
void |
assertSelectOptionValueNotPresent(String selectName,
String optionValue)
Assert that a specific option value is not present in a select box.
|
void |
assertSelectOptionValuePresent(String selectName,
int index,
String optionValue)
Assert that a specific option is present in the Nth select box (by value).
|
void |
assertSelectOptionValuePresent(String selectName,
String optionValue)
Assert that a specific option is present in a select box (by value).
|
void |
assertSelectOptionValuesEqual(String selectName,
int index,
String[] expectedValues)
Assert that the values of the Nth select element's options match
a given array of strings.
|
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,
int index,
String[] optionValues)
Assert that the values of the Nth select element's options do not 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,
int index,
String[] optionValues)
Assert that given options are present in the Nth select box (by value).
|
void |
assertSelectOptionValuesPresent(String selectName,
String[] optionValues)
Assert that given options are present in a select box (by value).
|
void |
assertSubmitButtonNotPresent()
Assert that no submit button is present in the current form.
|
void |
assertSubmitButtonNotPresent(String buttonName)
Assert that a submit button with a given name is not present.
|
void |
assertSubmitButtonPresent()
Assert that a submit button is present.
|
void |
assertSubmitButtonPresent(String buttonName)
Assert that a submit button with a given name is present.
|
void |
assertSubmitButtonPresent(String buttonName,
String buttonValue)
Assert that a submit button with a given name and value 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,
String[][] expectedTable)
Assert that a range of rows for a specific table matches a matrix of supplied regexps.
|
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 |
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 tableSummaryNameOrId,
String text)
Assert that supplied text is present in a specific table.
|
void |
assertTextInTable(String tableSummaryOrId,
String[] text)
Assert that a set of text values are all 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 |
assertTitleNotEquals(String title)
Assert title of current html page in conversation is not
equal to another value.
|
void |
assertTitleNotSame(String title)
Deprecated.
Replaced by
assertTitleNotEquals(String) |
void |
assertWindowCountEquals(int windowCount)
Assert that the number of opened windows equals given value.
|
void |
assertWindowPresent(int windowID)
Assert that a window with the given ID is open.
|
void |
assertWindowPresent(String windowName)
Assert that a window with the given name 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)
Select a specified checkbox.
|
void |
checkCheckbox(String checkBoxName,
String value)
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)
Navigate by selection of a link with the exact given text.
|
void |
clickLinkWithExactText(String linkText,
int index)
Navigate by selecting Nth link with the exact given text.
|
void |
clickLinkWithImage(String imageFileName)
Navigate by selection of a link with a given image.
|
void |
clickLinkWithImage(String imageFileName,
int index)
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()
Deprecated.
Use
getPageSource() |
void |
dumpHtml(PrintStream stream)
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.
|
Map<String,String> |
getAllHeaders()
Deprecated.
This method do not deal with several headers with same name. Use
getResponseHeaders() instead. |
List<String> |
getComments()
Get all the comments in a document, as a list of strings.
|
ITestingEngine |
getDialog()
Deprecated.
You should not use plugin specific functionality. Please ask for a new core feature instead.
|
String |
getElementAttributByXPath(String xpath,
String attribute)
Deprecated.
|
String |
getElementAttributeByXPath(String xpath,
String attribute)
Get the attribute value of the given element.
|
IElement |
getElementById(String id)
Get an element for a particular ID.
|
IElement |
getElementByXPath(String xpath)
Get an element for a particular xpath.
|
List<IElement> |
getElementsByXPath(String xpath)
Get elements for a particular xpath.
|
String |
getElementTextByXPath(String xpath)
Get text of the given element.
|
List<IElement> |
getFieldsForLabel(IElement label)
Get all the fields of type
input , textarea or select
that are referenced or contained in a particular label. |
String |
getFormElementValue(String formElementName)
Deprecated.
|
String |
getHeader(String name)
Get a particular header value.
|
Image |
getImage(String imageSrc,
String imageAlt) |
String |
getLabeledFieldValue(String identifier,
IElement label)
Get the current value of a given labelled field.
|
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.
|
List<HttpHeader> |
getResponseHeaders()
Return all HTTP headers that are in last response.
|
String |
getServerResponse()
Get the last data sent by the server.
|
String |
getServeurResponse()
Deprecated.
|
Table |
getTable(String tableSummaryNameOrId) |
TestContext |
getTestContext()
Provide access to test testContext.
|
ITestingEngine |
getTestingEngine()
Protected version of deprecated getDialog().
|
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(int windowID)
Deprecated.
Javascript ID does'nt not exists. Currently this is an index
in the list of available windows, but this is not portable (and probably not stable).
Use
gotoWindow(String) or gotoWindowByTitle(String) instead. |
void |
gotoWindow(String windowName)
Make a given window active.
|
void |
gotoWindowByTitle(String title)
Make first window with the given title active.
|
boolean |
hasElementById(String id)
Returns
true if an element with the given ID exists. |
boolean |
hasElementByXPath(String xpath)
Return
true if the given element by XPath exists. |
boolean |
hasElementsByXPath(String xpath)
Return
true if the given elements by XPath exists. |
protected ITestingEngine |
initializeDialog()
Initializes the IJWebUnitDialog when the testing engine is null.
|
void |
reset()
Reset the current form using the default reset button.
|
void |
saveAs(File f)
Save the last downloaded page (or file) to the disk.
|
void |
selectOption(String selectName,
int index,
String label)
Select an option with a given display label in Nth select element.
|
void |
selectOption(String selectName,
String label)
Select an option with a given display label in a select element.
|
void |
selectOptionByValue(String selectName,
int index,
String value)
Select an option with a given value in a select element.
|
void |
selectOptionByValue(String selectName,
String value)
Select an option with a given value in the Nth select element.
|
void |
selectOptions(String selectName,
int index,
String[] labels)
Select options with given display labels in the Nth select element.
|
void |
selectOptions(String selectName,
String[] labels)
Select options with given display labels in a select element.
|
void |
selectOptionsByValues(String selectName,
int index,
String[] values)
Select options with given values in the Nth select element.
|
void |
selectOptionsByValues(String selectName,
String[] values)
Select options with given values in a select element.
|
void |
setBaseUrl(String url)
Set the base url for the test context.
|
void |
setBaseUrl(URL url)
Set the base url for the test context.
|
void |
setDialog(ITestingEngine aIJWebUnitDialog)
Set the testing engine.
|
void |
setExpectedJavaScriptAlert(String message)
Tell that the given alert box 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)
Deprecated.
use
setTextField(String, String) or other methods |
void |
setHiddenField(String inputName,
String value)
Set the value of an hidden input field.
|
void |
setIgnoreFailingStatusCodes(boolean ignore)
Should the tester ignore failing status codes (300+)?
|
void |
setLabeledFormElementField(String id,
String value) |
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 |
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 |
setTimeout(int milli)
Set the timeout for the request.
|
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()
Submit form - default submit button will be used (unnamed submit button, or named button if there is only one on
the form.
|
void |
submit(String buttonName)
Submit form by pressing named button.
|
void |
submit(String buttonName,
String buttonValue)
Submit the form by pressing the named button with the given value (label).
|
void |
uncheckCheckbox(String checkBoxName)
Deselect a specified checkbox.
|
void |
uncheckCheckbox(String checkBoxName,
String value)
Deselect a specified checkbox.
|
public ITestingEngine getDialog()
public void setBaseUrl(String url)
url
- Base url value - A trailing "/" is appended if not provided.public void setBaseUrl(URL url)
url
- Base url value - A trailing "/" is appended if not provided.public ITestingEngine getTestingEngine()
protected ITestingEngine initializeDialog()
public void closeBrowser()
public void closeWindow()
public void setDialog(ITestingEngine aIJWebUnitDialog)
aIJWebUnitDialog
- Testing engine.public TestContext getTestContext()
public void setTestContext(TestContext aTestContext)
aTestContext
- public void beginAt(String aRelativeURL) throws TestingEngineResponseException
getTestContext().setBaseUrl(String)
to define base URL. Absolute URL
should start with "http://", "https://" or "www.".url
- absolute or relative URL (relative to base URL).TestingEngineResponseException
- If something bad happend (404)public String getMessage(String key)
key
- name of the web resource.public String getMessage(String key, Object[] args)
key
- name of the web resource.args
- array of arguments to be formatted into messageMessageFormat
public void assertResponseCode(int status)
status
- the expected status codepublic void assertResponseCodeBetween(int lower, int higher)
lower <= status <= higher
).lower
- the lower bound for the expected status codehigher
- the upper bound for the expected status codepublic void setIgnoreFailingStatusCodes(boolean ignore)
ignore
- public void assertHeaderPresent(String name)
name
- The header to findpublic void assertHeaderNotPresent(String name)
name
- The header to findpublic void assertHeaderEquals(String name, String value)
name
- Header to findvalue
- Value to compare againstpublic void assertHeaderMatches(String name, String regexp)
name
- Header to findregexp
- Pattern to compare againstpublic String getHeader(String name)
name
- Header to find@Deprecated public Map<String,String> getAllHeaders()
getResponseHeaders()
instead.public List<HttpHeader> getResponseHeaders()
HttpHeader
elements.public void assertTitleEquals(String title)
title
- expected title value@Deprecated public void assertTitleNotSame(String title)
assertTitleNotEquals(String)
title
- unexpected title valuepublic void assertTitleNotEquals(String title)
title
- unexpected title valuepublic void assertTitleMatch(String regexp)
regexp
- expected title regexppublic void assertTitleEqualsKey(String titleKey)
titleKey
- web resource key for titlepublic void assertTitleEqualsKey(String titleKey, Object[] args)
titleKey
- args
- public void assertKeyPresent(String key)
key
- web resource namepublic void assertKeyPresent(String key, Object[] args)
key
- args
- public void assertTextPresent(String text)
text
- public void assertMatch(String regexp)
regexp
- public void assertMatch(String regexp, String text)
regexp
- text
- public void assertNotMatch(String regexp, String text)
regexp
- text
- public void assertMatch(String message, String regexp, String text)
regexp
- text
- public void assertNotMatch(String message, String regexp, String text)
regexp
- text
- public void assertKeyNotPresent(String key)
key
- web resource namepublic void assertKeyNotPresent(String key, Object[] args)
key
- web resource namepublic void assertTextNotPresent(String text)
text
- public void assertNoMatch(String regexp)
regexp
- public Table getTable(String tableSummaryNameOrId)
tableSummaryNameOrId
- public void assertTablePresent(String tableSummaryNameOrId)
tableSummaryNameOrId
- summary, name or id attribute value of tablepublic void assertTableNotPresent(String tableSummaryNameOrId)
tableSummaryNameOrId
- summary, name or id attribute value of tablepublic void assertKeyInTable(String tableSummaryOrId, String key)
tableSummaryOrId
- summary or id attribute value of tablekey
- web resource namepublic void assertKeyInTable(String tableSummaryOrId, String key, Object[] args)
tableSummaryOrId
- summary or id attribute value of tablekey
- web resource namepublic void assertTextInTable(String tableSummaryNameOrId, String text)
tableSummaryNameOrId
- summary, name or id attribute value of tabletext
- public void assertMatchInTable(String tableSummaryNameOrId, String regexp)
tableSummaryNameOrId
- summary, name or id attribute value of tableregexp
- public void assertKeysInTable(String tableSummaryOrId, String[] keys)
tableSummaryOrId
- summary, name or id attribute value of tablekeys
- Array of web resource names.public void assertKeysInTable(String tableSummaryOrId, String[] keys, Object[][] args)
tableSummaryOrId
- summary or id attribute value of tablekeys
- Array of web resource names.public void assertTextInTable(String tableSummaryOrId, String[] text)
tableSummaryOrId
- summary, name or id attribute value of tabletext
- Array of expected text values.public void assertMatchInTable(String tableSummaryOrId, String[] regexp)
tableSummaryOrId
- summary, name or id attribute value of tabletext
- Array of expected regexps to match.public void assertKeyNotInTable(String tableSummaryOrId, String key)
tableSummaryOrId
- summary, name or id attribute value of tablekey
- web resource namepublic void assertTextNotInTable(String tableSummaryNameOrId, String text)
tableSummaryNameOrId
- summary, name or id attribute value of tabletext
- public void assertTextNotInTable(String tableSummaryNameOrId, String[] text)
tableSummaryNameOrId
- summary, name or id attribute value of tabletext
- Array of text valuespublic void assertNoMatchInTable(String tableSummaryNameOrId, String regexp)
tableSummaryNameOrId
- summary, name or id attribute value of tabletext
- public void assertNoMatchInTable(String tableSummaryNameOrId, String[] regexp)
tableSummaryNameOrId
- summary, name or id attribute value of tabletext
- Array of text valuespublic void assertTableEquals(String tableSummaryNameOrId, Table expectedTable)
tableSummaryNameOrId
- summary, name or id attribute value of tableexpectedTable
- represents expected values (colspan supported).public void assertTableEquals(String tableSummaryNameOrId, String[][] expectedCellValues)
tableSummaryNameOrId
- summary, name or id attribute value of tableexpectedCellValues
- double dimensional array of expected valuespublic void assertTableRowsEqual(String tableSummaryNameOrId, int startRow, Table expectedTable)
tableSummaryNameOrId
- summary, name or id attribute value of tablestartRow
- index of start row for comparisonexpectedTable
- represents expected values (colspan and rowspan supported).public void assertTableRowsEqual(String tableSummaryNameOrId, int startRow, String[][] expectedTable)
tableSummaryNameOrId
- summary, name or id attribute value of tablestartRow
- index of start row for comparisonexpectedTable
- represents expected values (colspan and rowspan supported).public void assertTableRowCountEquals(String tableSummaryNameOrId, int expectedRowCount)
tableSummaryNameOrId
- summary, name or id attribute value of tableexpectedRowCount
- expected row count.public void assertTableMatch(String tableSummaryOrId, Table expectedTable)
tableSummaryOrId
- summary or id attribute value of tableexpectedTable
- represents expected regexps (colspan supported).public void assertTableMatch(String tableSummaryOrId, String[][] expectedCellValues)
tableSummaryOrId
- summary or id attribute value of tableexpectedCellValues
- double dimensional array of expected regexpspublic void assertTableRowsMatch(String tableSummaryOrId, int startRow, Table expectedTable)
tableSummaryOrId
- summary or id attribute value of tablestartRow
- index of start row for comparisonexpectedTable
- represents expected regexps (colspan and rowspan supported).public void assertTableRowsMatch(String tableSummaryOrId, int startRow, String[][] expectedTable)
tableSummaryOrId
- summary or id attribute value of tablestartRow
- index of start row for comparisonexpectedTable
- represents expected regexps (colspan and rowspan not supported).public void assertFormElementPresent(String formElementName)
formElementName
- public void assertFormElementNotPresent(String formElementName)
formElementName
- public void assertCheckboxPresent(String checkboxName)
checkboxName
- checkbox name.public void assertCheckboxPresent(String checkboxName, String checkboxValue)
checkboxName
- checkbox name attribut.checkboxValue
- checkbox value attribut.public void assertCheckboxNotPresent(String checkboxName)
checkboxName
- checkbox name.public void assertCheckboxNotPresent(String checkboxName, String checkboxValue)
checkboxName
- checkbox name.checkboxValue
- checkbox value attribut.public void assertFormPresent()
public void assertFormPresent(String nameOrID)
nameOrID
- public void assertFormPresent(String nameOrID, int index)
nameOrID
- index
- The 0-based index, when more than one form with the same name is expected.public void assertFormNotPresent()
public void assertFormNotPresent(String nameOrID)
nameOrID
- public void assertFormElementEquals(String formElementName, String expectedValue)
assertTextFieldEquals(String, String)
formElementName
- expectedValue
- assertTextFieldEquals(String, String)
public void assertFormElementMatch(String formElementName, String regexp)
formElementName
- regexp
- public void assertFormElementEmpty(String formElementName)
setTextField(String, String)
or setHiddenField(String, String)
formElementName
- setTextField(String, String)
,
setHiddenField(String, String)
public void assertTextFieldEquals(String formElementName, String expectedValue)
formElementName
has the expectedValue
value.formElementName
- the value of the name attribute of the elementexpectedValue
- the expected value of the given input elementpublic void assertHiddenFieldPresent(String formElementName, String expectedValue)
formElementName
has the expectedValue
value.formElementName
- the value of the name attribute of the elementexpectedValue
- the expected value of the given input elementpublic void assertCheckboxSelected(String checkBoxName)
checkBoxName
- public void assertCheckboxSelected(String checkBoxName, String checkBoxValue)
checkBoxName
- checkBoxValue
- public void assertCheckboxNotSelected(String checkBoxName)
checkBoxName
- public void assertCheckboxNotSelected(String checkBoxName, String checkBoxValue)
checkBoxName
- checkBoxValue
- public void assertRadioOptionPresent(String name, String radioOption)
name
- radio group name.radioOption
- option to test for.public void assertRadioOptionNotPresent(String name, String radioOption)
name
- radio group name.radioOption
- option to test for.public void assertRadioOptionSelected(String name, String radioOption)
name
- radio group name.radioOption
- option to test for selection.public void assertRadioOptionNotSelected(String name, String radioOption)
name
- radio group name.radioOption
- option to test for selection.public void assertSelectOptionsPresent(String selectName, String[] optionLabels)
selectName
- name of the select element.optionLabels
- option labels.public void assertSelectOptionPresent(String selectName, String optionLabel)
selectName
- name of the select element.optionLabel
- option label.public void assertSelectOptionsPresent(String selectName, int index, String[] optionLabels)
selectName
- name of the select element.index
- the 0-based index of the select element when multiple
select elements are expected.optionLabels
- option labels.public void assertSelectOptionPresent(String selectName, int index, String optionLabel)
selectName
- name of the select element.index
- the 0-based index of the select element when multiple
select elements are expected.optionLabel
- option label.public void assertSelectOptionValuesPresent(String selectName, String[] optionValues)
selectName
- name of the select element.optionValues
- option labels.public void assertSelectOptionValuePresent(String selectName, String optionValue)
selectName
- name of the select element.optionValue
- option value.public void assertSelectOptionValuesPresent(String selectName, int index, String[] optionValues)
selectName
- name of the select element.index
- the 0-based index of the select element when multiple
select elements are expected.optionValues
- option labels.public void assertSelectOptionValuePresent(String selectName, int index, String optionValue)
selectName
- name of the select element.index
- the 0-based index of the select element when multiple
select elements are expected.optionValue
- option value.public void assertSelectOptionValueNotPresent(String selectName, String optionValue)
selectName
- name of the select element.optionValue
- option value.public void assertSelectOptionNotPresent(String selectName, String optionLabel)
selectName
- name of the select element.expectedOption
- option label.public void assertSelectOptionValueNotPresent(String selectName, int index, String optionValue)
selectName
- name of the select element.optionValue
- option value.public void assertSelectOptionNotPresent(String selectName, int index, String optionLabel)
selectName
- name of the select element.expectedOption
- option label.public void assertSelectOptionsEqual(String selectName, String[] expectedOptions)
selectName
- name of the select element.expectedOptions
- expected labels for the select box.public void assertSelectOptionsEqual(String selectName, int index, String[] expectedOptions)
selectName
- name of the select element.index
- the 0-based index of the select element when multiple
select elements are expected.expectedOptions
- expected labels for the select box.public void assertSelectOptionsNotEqual(String selectName, String[] expectedOptions)
selectName
- name of the select element.expectedOptions
- expected display values for the select box.public void assertSelectOptionsNotEqual(String selectName, int index, String[] expectedOptions)
selectName
- name of the select element.index
- the 0-based index of the select element when multiple
select elements are expected.expectedOptions
- expected display values for the select box.public void assertSelectOptionValuesEqual(String selectName, int index, String[] expectedValues)
selectName
- name of the select element.index
- the 0-based index of the select element when multiple
select elements are expected.expectedValues
- expected values for the select box.public void assertSelectOptionValuesEqual(String selectName, String[] expectedValues)
selectName
- name of the select element.expectedValues
- expected values for the select box.public void assertSelectOptionValuesNotEqual(String selectName, String[] optionValues)
selectName
- name of the select element.optionValues
- expected values for the select box.public void assertSelectOptionValuesNotEqual(String selectName, int index, String[] optionValues)
selectName
- name of the select element.index
- the 0-based index of the select element when multiple
select elements are expected.optionValues
- expected values for the select box.public void assertSelectedOptionsEqual(String selectName, String[] labels)
selectName
- name of the select element.labels
- expected display label(s) of the selected option.public void assertSelectedOptionsEqual(String selectName, int index, String[] labels)
selectName
- name of the select element.index
- the 0-based index used when more than one select element
with the same name is expected.labels
- expected display label(s) of the selected option.public void assertSelectedOptionEquals(String selectName, String optionLabel)
selectName
- name of the select elementoptionLabel
- expected value of the option labelpublic void assertSelectedOptionEquals(String selectName, int index, String option)
selectName
- name of the select elementindex
- the 0-based index used when more than one select element
with the same name is expected.optionLabel
- expected value of the option labelpublic void assertSelectedOptionValuesEqual(String selectName, String[] values)
selectName
- name of the select element.values
- expected value(s) of the selected option.public void assertSelectedOptionValuesEqual(String selectName, int index, String[] values)
selectName
- name of the select element.index
- the 0-based index used when more than one select element
with the same name is expected.values
- expected value(s) of the selected option.public void assertSelectedOptionValueEquals(String selectName, String value)
selectName
- name of the select element.value
- expected value of the selected option.public void assertSelectedOptionValueEquals(String selectName, int index, String value)
selectName
- name of the select element.index
- the 0-based index used when more than one select element
with the same name is expected.value
- expected value of the selected option.public void assertSelectedOptionsMatch(String selectName, String[] regexps)
selectName
- name of the select element.regexps
- expected display value of the selected option.public void assertSelectedOptionsMatch(String selectName, int index, String[] regexps)
selectName
- name of the select element.index
- the 0-based index used when more than one select element
with the same name is expected.regexps
- expected display value of the selected option.public void assertSelectedOptionMatches(String selectName, String regexp)
selectName
- name of the select elementregexp
- the regular expression to matchpublic void assertSelectedOptionMatches(String selectName, int index, String regexp)
selectName
- name of the select elementindex
- the 0-based index used when more than one select element
with the same name is expected.regexp
- the regular expression to matchpublic void assertSubmitButtonPresent()
public void assertSubmitButtonPresent(String buttonName)
buttonName
- public void assertSubmitButtonNotPresent()
buttonName
- public void assertSubmitButtonNotPresent(String buttonName)
buttonName
- public void assertSubmitButtonPresent(String buttonName, String buttonValue)
buttonName
- buttonValue
- public void assertResetButtonPresent()
public void assertResetButtonPresent(String buttonName)
buttonName
- public void assertResetButtonNotPresent()
buttonName
- public void assertResetButtonNotPresent(String buttonName)
buttonName
- public void assertButtonPresent(String buttonId)
buttonId
- public void assertButtonPresentWithText(String text)
text
- Text representation of button content.public void assertButtonNotPresentWithText(String text)
text
- Text representation of button content.public void assertButtonNotPresent(String buttonId)
buttonId
- public void assertLinkPresent(String linkId)
linkId
- public void assertLinkNotPresent(String linkId)
linkId
- public void assertLinkPresentWithText(String linkText)
linkText
- public void assertLinkNotPresentWithText(String linkText)
linkText
- public void assertLinkPresentWithText(String linkText, int index)
linkText
- index
- The 0-based index, when more than one link with the same text is expected.public void assertLinkNotPresentWithText(String linkText, int index)
linkText
- index
- The 0-based index, when more than one link with the same text is expected.public void assertLinkPresentWithExactText(String linkText)
linkText
- public void assertLinkNotPresentWithExactText(String linkText)
linkText
- public void assertLinkPresentWithExactText(String linkText, int index)
linkText
- index
- The 0-based index, when more than one link with the same text is expected.public void assertLinkNotPresentWithExactText(String linkText, int index)
linkText
- index
- The 0-based index, when more than one link with the same text is expected.public void assertLinkPresentWithImage(String imageFileName)
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 assertLinkPresentWithImage(String imageFileName, int index)
imageFileName
- A suffix of the image's filename; for example, to match "images/my_icon.png",
you could just pass in "my_icon.png".index
- The 0-based index, when more than one link with the same image is expected.public void assertLinkNotPresentWithImage(String imageFileName)
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 assertLinkNotPresentWithImage(String imageFileName, int index)
imageFileName
- A suffix of the image's filename; for example, to match "images/my_icon.png",
you could just pass in "my_icon.png".index
- The 0-based index, when more than one link with the same image is expected.public void assertElementPresent(String anID)
anID
- element id to test for.public void assertElementNotPresent(String anID)
anID
- element id to test for.public void assertElementPresentByXPath(String xpath)
xpath
- element xpath to test for.public void assertElementNotPresentByXPath(String xpath)
xpath
- element xpath to test for.public List<String> getComments()
public void assertCommentPresent(String comment)
comment
- public void assertCommentNotPresent(String comment)
comment
- public void assertTextInElement(String elementID, String text)
elementID
- id of element to be inspected.text
- to check for.public void assertMatchInElement(String elementID, String regexp)
elementID
- id of element to be inspected.regexp
- to match.public void assertNoMatchInElement(String elementID, String regexp)
elementID
- id of element to be inspected.regexp
- to match.public void assertWindowPresent(String windowName)
windowName
- public void assertWindowPresent(int windowID)
windowID
- Javascript window ID.public void assertWindowPresentWithTitle(String title)
title
- public void assertWindowCountEquals(int windowCount)
windowCount
- Window countpublic void assertFramePresent(String frameNameOrId)
frameNameOrId
- Name or ID of the frame. ID is checked first.public void assertCookiePresent(String cookieName)
cookieName
- The cookie namepublic void assertCookieValueEquals(String cookieName, String expectedValue)
cookieName
- The cookie nameexpectedValue
- The cookie valuepublic void assertCookieValueMatch(String cookieName, String regexp)
cookieName
- The cookie nameregexp
- The regexppublic String getFormElementValue(String formElementName)
getElementAttributeByXPath(String, String)
public void setWorkingForm(int index)
index
- 0-based index of the form to work with.public void setWorkingForm(String nameOrId)
nameOrId
- name or id of the form to work with.public void setWorkingForm(String nameOrId, int index)
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 setTextField(String inputName, String value)
inputName
- name of form element.value
- value to set.public void setHiddenField(String inputName, String value)
inputName
- name of form element.value
- value to set.public void checkCheckbox(String checkBoxName)
checkBoxName
- name of checkbox to be selected.public void checkCheckbox(String checkBoxName, String value)
checkBoxName
- name of checkbox to be selected.value
- value of checkbox to be selected.public void uncheckCheckbox(String checkBoxName)
checkBoxName
- name of checkbox to be deselected.public void uncheckCheckbox(String checkBoxName, String value)
checkBoxName
- name of checkbox to be deselected.value
- value of checkbox to be deselected.public void selectOptions(String selectName, String[] labels)
selectName
- name of select element.labels
- labels of options to be selected.public void selectOption(String selectName, String label)
selectName
- name of select element.label
- label of option to be selected.public void selectOption(String selectName, int index, String label)
selectName
- name of select element.index
- the 0-based index of the select element when multiple
select elements are expected.label
- label of option to be selected.public void selectOptions(String selectName, int index, String[] labels)
selectName
- name of select element.index
- the 0-based index of the select element when multiple
select elements are expected.labels
- labels of options to be selected.public void selectOptionsByValues(String selectName, String[] values)
selectName
- name of select element.values
- values of options to be selected.public void selectOptionByValue(String selectName, String value)
selectName
- name of select element.index
- the 0-based index of the select element when multiple
select elements are expected.values
- values of options to be selected.public void selectOptionsByValues(String selectName, int index, String[] values)
selectName
- name of select element.index
- the 0-based index of the select element when multiple
select elements are expected.values
- values of options to be selected.public void selectOptionByValue(String selectName, int index, String value)
selectName
- name of select element.values
- values of options to be selected.public void submit()
public void submit(String buttonName)
buttonName
- Submit button name attribut value.public void submit(String buttonName, String buttonValue)
buttonName
- Submit button name attribut value.buttonValue
- Submit button value attribut value.public void reset()
#getForm
for an explanation of how the current
form is established.public void clickLinkWithText(String linkText)
linkText
- Text in the link.public void clickLinkWithText(String linkText, int index)
linkText
- Text in the link.index
- The 0-based index, when more than one link with the same text is expected.public void clickLinkWithExactText(String linkText)
linkText
- Text of the link.public void clickLinkWithExactText(String linkText, int index)
linkText
- Text of the link.index
- The 0-based index, when more than one link with the same text is expected.public void clickButton(String buttonId)
buttonId
- Button ID attribut value.public void clickButtonWithText(String buttonValueText)
text
of the value attribute.buttonValueText
- The text of the button (contents of the value attribute).public void clickLinkWithImage(String imageFileName)
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 clickLinkWithImage(String imageFileName, int index)
imageFileName
- A suffix of the image's filename; for example, to match "images/my_icon.png",
you could just pass in "my_icon.png".index
- The 0-based index, when more than one link with the same image is expected.public void clickLink(String linkId)
linkId
- id of linkpublic void clickRadioOption(String radioGroup, String radioOption)
radioGroup
- name of the radio group.radioOption
- value of the option to check for.public void clickElementByXPath(String xpath)
xpath
- xpath of the element.public String getElementAttributeByXPath(String xpath, String attribute)
<img src="test.gif" alt="picture">
getElementAttributeByXPath("//img[@src='test.gif']", "alt") returns "picture".xpath
- XPath of the elementattribute
- Name of the attributepublic String getElementAttributByXPath(String xpath, String attribute)
getElementAttributeByXPath(String, String)
public String getElementTextByXPath(String xpath)
xpath
- xpath of the element.public IElement getElementByXPath(String xpath)
xpath
- XPath to searchAssertionError
- if the element xpath is not foundpublic boolean hasElementByXPath(String xpath)
true
if the given element by XPath exists.xpath
- XPath to searchtrue
if the the requested elementAssertionError
- if the element xpath is not foundpublic IElement getElementById(String id)
id
- element ID to findAssertionError
- if the element is not foundpublic boolean hasElementById(String id)
true
if an element with the given ID exists.id
- element ID to findtrue
if the element ID exists, false
otherwisepublic List<IElement> getElementsByXPath(String xpath)
xpath
- XPath to searchpublic boolean hasElementsByXPath(String xpath)
true
if the given elements by XPath exists.xpath
- XPath to searchtrue
if the given elements by XPath existpublic void assertLabelPresent(String id)
public void assertLabelMatches(String regexp)
public List<IElement> getFieldsForLabel(IElement label)
input
, textarea
or select
that are referenced or contained in a particular label.label
- The label to considerpublic String getLabeledFieldValue(String identifier, IElement label)
identifier
- the HTML ID for the given labelled fieldlabel
- the label found for the given HTML IDnull
if none was foundpublic void assertLabeledFieldEquals(String id, String fieldText)
id
- the HTML ID for the given labelled fieldfieldText
- the text that the field's value should equal#getLabeledFieldValue(String, IElement, String)
,
getLabel(String)
public void gotoWindow(String windowName)
windowName
- Name of the window.@Deprecated public void gotoWindow(int windowID)
gotoWindow(String)
or gotoWindowByTitle(String)
instead.windowID
- Javascript ID of the windowpublic void gotoRootWindow()
ITestingEngine.gotoFrame(String)
.public void gotoWindowByTitle(String title)
title
- Title of the window.public void gotoFrame(String frameNameOrId)
frameNameOrId
- Name or ID of the frame. ID is checked first.public void gotoPage(String url) throws TestingEngineResponseException
getTestContext().setBaseUrl(String)
to define base URL. Absolute URL
should start with "http://", "https://" or "www.".url
- absolute or relative URL (relative to base URL).TestingEngineResponseException
- If something bad happend (404)public void dumpCookies()
public String getPageSource()
public String getServerResponse()
public String getServeurResponse()
getServerResponse()
public void saveAs(File f)
f
- The file name.public void assertDownloadedFileEquals(URL expected)
expected
- Expected file URL.public void dumpHtml()
getPageSource()
stream
- public void dumpHtml(PrintStream stream)
getPageSource()
stream
- public void dumpTable(String tableNameOrId)
tableNameOrId
- stream
- public void dumpTable(String tableNameOrId, PrintStream stream)
tableNameOrId
- table
- stream
- public void setScriptingEnabled(boolean value)
public void setTestingEngineKey(String testingEngineKey)
testingEngineKey
- The testingEngineKey to set.TestingEngineRegistry
public String getTestingEngineKey()
public void setFormElement(String formElementName, String value)
setTextField(String, String)
or other methodsformElementName
- name of form element.value
- setTextField(String, String)
public void setExpectedJavaScriptAlert(String message)
message
- Message in the alert.public void setExpectedJavaScriptAlert(String[] messages)
messages
- Messages in the alerts.public void setExpectedJavaScriptConfirm(String message, boolean action)
message
- Message in the confirm.action
- Whether we should click on "OK" (true) or "Cancel" (false)public void setExpectedJavaScriptConfirm(String[] messages, boolean[] actions)
messages
- Messages in the confirms.actions
- Whether we should click on "OK" (true) or "Cancel" (false)public void setExpectedJavaScriptPrompt(String message, String input)
message
- Message in the prompt.input
- What we should put in the prompt (null if user press Cancel)public void setExpectedJavaScriptPrompt(String[] messages, String[] inputs)
messages
- Messages in the prompts.inputs
- What we should put in the prompt (null if user press Cancel)public void assertImagePresent(String imageSrc, String imageAlt)
imageSrc
- Value of image src attribute.imageAlt
- Value of image alt attribute. Ignored when null.public void assertImagePresentPartial(String partialImageSrc, String partialImageAlt)
partialImageSrc
- partialImageAlt
- public void assertImageValidAndStore(String imageSrc, String imageAlt, File out)
imageSrc
- as it appears in the html page, i.e. relative to the current page.public void setTimeout(int milli)
milli
- the milliseconds in which to timeout, or 0 for infinite
wait (the default).protected boolean areFilesEqual(URL f1, URL f2) throws IOException
IOException
Copyright © 2002-2015 JWebUnit. All Rights Reserved.