WebTest Reference

This page lists all available methods in the WebTest fixture for customer-friendly web testing through FitNesse and Selenium. See main WebTest page for more information (especially on getting started). Method arguments are marked as bold.

WebTest does a lot of smart mapping to identify fields, button and elements by captions, names, DOM element IDs and contained text. In most cases, you should be able to identify any element by the text that is actually displayed to the user on the screen. You can also use the DOM element ID (tests will run faster if you do).

• Start the browser (call this method to initialise the test)

• Shut down the browser (call this method on the end of the test)

• navigate to a URL during the test (change active page)

• check current browser URL

• check that the page loads fully within given time (use after user opens url)

• check that page contains some text (regardless of whether text is visible or not)

• check that text does not appear anywhere on the page (including hidden parts)

• check that page contains an element (hidden or visible)

• check that page does not contain an element (hidden or visible)

• check whether an element exists but is hidden

• check whether an element is disabled

• check whether an element is enabled

• check whether a button is disabled (can also locate buttons by captions/values)

• check whether a button is enabled (can also locate buttons by captions/values)

• check whether a check box is disabled (can also locate check boxes by values)

• check whether a check box is enabled (can also locate check boxes by values)

• check whether a check box is checked (confirmed)

or

• check whether a check box is not checked (confirmed)

or

• check whether a radio button is selected (confirmed)

or

• check whether a check box is not checked (confirmed)

or

• check whether a field is editable

• check whether a field is disabled (not editable)

• check whether a text field or area contains given text (as a substring)

• check whether an element contains given text (as a substring). this can be used to check for text labels.

• check value of an input element

• check text in a DOM element (can be used to check for labels)

• check that a JavaScript alert pops up with a given message (will confirm the alert as well)

or (this will also print the current value if it is different then expected)

• print the current JavaScript alert, and confirm it

• check that a JavaScript confirmation pops up with a given message (will confirm the box as well)

• print the current JavaScript confirmation, and confirm it

• check the selected option in a select/drop-down box by label

• list available options in a drop down box (the second row must contain text value, this is an ArrayFixture)

or

• trigger a DOM event manually. Don't prefix the element with on (use change and not onchange). You can fire any applicable DOM event with this.

• click on any element

• click on a button (will fail if the element is not a button). This method can locate buttons by value as well.

• click on a check box(will fail if the element is not a check box). This method can locate check boxes by value as well.

• click on a radio button(will fail if the element is not a radio button). This method can locate radio buttons by value as well.

• select an option from a select/drop-down box

• type text into a text field

• pause for a number of seconds

• wait for an element to appear

• wait for an element to disappear

• wait for text to appear anywhere in the page (visible or hidden)

• wait for text to disappear from the page (visible or hidden)

• wait for an input field to get certain value

• wait for an element to contain certain text