When testing web pages, you often need to find web page elements by using the element text. TestComplete provides access to the methods and properties of web page elements so you can search all web page elements and find the desired text in the element properties.

Page.NativeWebObject.Find(PropertyName, KeyValue, TagName)

• PropertyName - Name of the property, whose value is checked by the method. Typically, the element’s text is accessible through the innerHTML or innerText property.
• KeyValue - The sought-for text. You can use the * and ? wildcards to specify the search masks.
• TagName - This parameter is optional. You can use it to specify tag names that you would like to search in.

Since the name of the Find method coincides with the name of the Find method added to all tested objects by TestComplete, the Page object’s method resides in the NativeWebObject namespace, that is, in your script you should call Page.NativeWebObject.Find rather than Page.Find.

The following code demonstrates how you can use the method to search for the object containing the string, "Johns". (Ed. Note: We all know how hard it can be to find a John when you need one.) The sample routine works with the web page that displays the orders list. To view this page, open the page <TestComplete>\Samples\Open Apps\OrdersDemo\Web\Start.htm in your Internet browser and click View all orders. The test script works with Internet Explorer 6. If you use another browser, you will need to modify the script lines responsible for obtaining the Page object and the document object.

The Find method frees you from writing code that parses the web page element's tree. However, the method always starts the search from the top level of the element’s hierarchy and if you have two elements containing the same text, the method may return a different element than what you expect. In this case, you should add a special search method. Below is an example of this type of script routine. The SearchForText routine can perform the search from any level of the element’s hierarchy:

Note that the SearchForText routine returns a DOM object containing the sought-for text. This object does not contain methods and properties provided by TestComplete. To find the TestComplete object corresponding to the found object, we call the FindChild method. It searches for an object by its property values. To find the object, select the property or properties that uniquely identify the element on the page. In our example we used the uniqueID property - it contains a unique element’s identifier generated by the browser. Note, however, that this property is available if the web pages is displayed in Internet Explorer or in the WebBrowser control. If you use TestComplete 5 to test a web page shown in Firefox, you have to find another property or properties. For instance, you can use the combination of the tagName, innerHTML, offsetTop and offsetLeft properties (you can also use offsetTop and offsetHeight properties or the clientTop, clientLeft, clientWidth and clientHeight properties).