docs contrib by Thwameva, Bangalore's most innovative software testing course methodology

Public Class methods

Constructor to create a WebEdit. Scripts should not directly create instances of this class. It is typically done by the Containers (Browser, Frame & Table) using the WebContainer.TextField(*args) method.

Public Instance methods

append(txt)

Appends the text in the passed parameter to the end of the current text in the textfield.

check_exists()

Check to see if the textfield actually exists on the page.If the textfield actually does exist,then prints out a success message in the test report.If it doesn’t exist,then it prints out a failure in the report. One example of using this check is immediately after performing ‘add’operations.For example,after adding a new user,you may want to check that the user link actually does exist.

check_not_exists()

Check to see if the textfield *does not*exist on the page.If the textfield does not exist,then prints out a success message in the test report.If it actually does exist,then it prints out a failure in the report. One example of using this check is immediately after performing ‘delete’operations.For example,after deleting user ‘abc’,you may want to check that the user link for ‘abc’has been deleted.

check_property(name, expected_value)

 Check if a property's actual value matches the expected value.The property to be checked is the first parameter and
 the expected value is the second parameter.The common properties that are checked for a textfield are:

 name       -     The html name attribute of the textfield
 id         -     The html id attribute of the textfield.
 label      -     The text displayed next to the textfield which
                  typically identifies the purpose of the textfield.
 suffix     -     Sometimes it is useful to know that the text immediately after
                  the textfield.
 text       -     The current value of the textfield.
 readonly   -     Is the textfield readonly?

Besides the above properties you could use any of the properties of the MSHtml Edit object.The properties are enumerated at: msdn.microsoft.com/library/default.asp?url=/workshop/author/dhtml/reference/objects/input_text.asp

If the result is a success then prints a Success to the report,otherwise prints a failure.

check_text(search_text)

Check to see if the expected text matches the text of the textfield.If the textfield’s text matches the search_text,then a success message is printed in the test report. Otherwise,a failure is printed in the test report.

check_text_absent(search_text)

Check to see if the expected text does not match the text of the textfield.If the check is successful,that is,the textfield’s text does not match the expected text, then a success is printed in the test report.If the check fails,then a failure is printed in the test report

clear()

Performs a clear operation,which clears the text of the required field.

clear_without_blocking()

clear text on the textfield without blocking the current process. This is typically required if the textfield has javascript events which does validation and these validation opens popups.

max_length()

readonly?()

set(value)

Sets the textfield’s text to ‘value’

set_without_blocking(value)

set text on the textfield without blocking the current process. This is typically required if the textfield has javascript events which does validation and these validation opens popups.

size()

Number of characters the textfield can hold.

text()

Gets the current text value of the textfield.

to_s()