com.smartbear.testleft.testobjects.web

Interface WebObject

All Superinterfaces:

Control, ObjectTreeNode, TestObject, VisualObject

All Known Subinterfaces:

WebCell, WebElement, WebPage, WebTable

public interface WebObject
extends Control

The basic test interface for web objects (web elements, pages and dialogs).

Method Summary

Modifier and Type	Method and Description
Object	evaluateXPath(String xPath) Runs an XPath query and returns the result.
Object	evaluateXPath(String xPath, boolean searchInFrames) Runs an XPath query and returns the result.
<T extends WebObject> T	findChildByXPath(Class clazz, String xPath) Finds a child object that matches the specified XPath query.
<T extends WebObject> T	findChildByXPath(Class clazz, String xPath, boolean searchInFrames)
<T extends WebObject> T	querySelector(Class clazz, String selector) Finds a child object that matches the specified CSS selector.
<T extends WebObject> List<T>	querySelectorAll(Class clazz, String selector) Finds all child objects that match the specified CSS selector.

Methods inherited from interface com.smartbear.testleft.testobjects.Control

click, click, click, clickM, clickM, clickM, clickR, clickR, clickR, dblClick, dblClick, dblClick, dblClickM, dblClickM, dblClickM, dblClickR, dblClickR, dblClickR, drag, drag, dragM, dragM, dragR, dragR, getEnabled, getHeight, getScreenLeft, getScreenTop, getVisible, getVisibleOnScreen, getWidth, hoverMouse, hoverMouse, keys, mouseWheel, mouseWheel, screenToWindow, windowToScreen

Methods inherited from interface com.smartbear.testleft.testobjects.ObjectTreeNode

find, find, find, findAll, findAll, getChildren, getParent, tryFind, tryFind, tryFind, waitProperty, waitProperty

Methods inherited from interface com.smartbear.testleft.testobjects.VisualObject

picture, picture, picture

Methods inherited from interface com.smartbear.testleft.testobjects.TestObject

callMethod, callMethod, cast, getProperty, setProperty, toString

Method Detail

evaluateXPath

Object evaluateXPath(String xPath)
              throws InvocationException,
                     HttpException

Runs an XPath query and returns the result. The query can select one object, multiple objects, or it can return the result of an arbitrary XPath expression.

Parameters:

xPath - An XPath query.

Returns:

An object of the type TestObject that matches the specified XPath query, or the List object that contains one or more objects of the type TestObject, or simple types that match the specified XPath query, or an object of a simple type (string, int, etc.) as the result of a call to the XPath function or null.

Throws:

InvocationException - Will be thrown if invocation fails.

HttpException - Will be thrown if there are network problems.

evaluateXPath

Object evaluateXPath(String xPath,
                     boolean searchInFrames)
              throws InvocationException,
                     HttpException

Runs an XPath query and returns the result. The query can select one object, multiple objects, or it can return the result of an arbitrary XPath expression.

Parameters:

xPath - An XPath query.

searchInFrames - Specifies whether to run the XPath query inside FRAMEs as well.

Returns:

An object of the type TestObject that matches the specified XPath query, or the List List object that contains one or more objects of the type TestObject, or simple types that match the specified XPath query, or an object of a simple type (string, int, etc.) as the result of a call to the XPath function or null.

Throws:

InvocationException - Will be thrown if invocation fails.

HttpException - Will be thrown if there are network problems.

findChildByXPath

<T extends WebObject> T findChildByXPath(Class clazz,
                                         String xPath)
                                  throws InvocationException,
                                         HttpException

Finds a child object that matches the specified XPath query.

Type Parameters:

T - The interface that will be implemented in the returned object.

Parameters:

clazz - The interface that will be implemented in the returned object.

xPath - The XPath query that describes the object to be returned.

Returns:

The found object or null.

Throws:

InvocationException - Will be thrown if invocation fails.

HttpException - Will be thrown if there are network problems.

findChildByXPath

<T extends WebObject> T findChildByXPath(Class clazz,
                                         String xPath,
                                         boolean searchInFrames)
                                  throws InvocationException,
                                         HttpException

Type Parameters:

T - The interface that will be implemented in the returned object.

Parameters:

clazz - The interface that will be implemented in the returned object.

xPath - The XPath query that describes the object to be returned.

searchInFrames - Specifies whether to search inside FRAMEs as well.

Returns:

The found object or null.

Throws:

InvocationException - Will be thrown if invocation fails.

HttpException - Will be thrown if there are network problems.

querySelector

<T extends WebObject> T querySelector(Class clazz,
                                      String selector)
                               throws InvocationException,
                                      HttpException

Finds a child object that matches the specified CSS selector.

Type Parameters:

T - The interface that will be implemented in the returned object.

Parameters:

clazz - The interface that will be implemented in the returned object.

selector - A CSS selector that describes the object to be returned.

Returns:

The found object or null.

Throws:

InvocationException - Will be thrown if invocation fails.

HttpException - Will be thrown if there are network problems.

querySelectorAll

<T extends WebObject> List<T> querySelectorAll(Class clazz,
                                               String selector)
                                        throws InvocationException,
                                               HttpException

Finds all child objects that match the specified CSS selector.

Type Parameters:

T - The interface that will be implemented in the collection items.

Parameters:

clazz - The interface that will be implemented in the collection items.

selector - A CSS selector that describes the objects to be returned.

Returns:

A collection of found objects.

Throws:

InvocationException - Will be thrown if invocation fails.

HttpException - Will be thrown if there are network problems.