com.vaadin.client.componentlocator
Class ComponentLocator

java.lang.Object
  com.vaadin.client.componentlocator.ComponentLocator

public class ComponentLocator
extends java.lang.Object

ComponentLocator provides methods for generating a String locator for a given DOM element and for locating a DOM element using a String locator.

The main use for this class is locating components for automated testing purposes.

Since:

7.2, moved from com.vaadin.client.ComponentLocator

Constructor Summary

ComponentLocator(ApplicationConnection client)
Construct a ComponentLocator for the given ApplicationConnection.

Method Summary

ApplicationConnection	getClient() Returns the ApplicationConnection used by this locator.
com.google.gwt.user.client.Element	getElementByPath(java.lang.String path) Locates an element using a String locator (path) which identifies a DOM element.
com.google.gwt.user.client.Element	getElementByPathStartingAt(java.lang.String path, Element root) Locates an element using a String locator (path) which identifies a DOM element.
	getElementsByPath(java.lang.String path) Locates elements using a String locator (path) which identifies DOM elements.
	getElementsByPathStartingAt(java.lang.String path, Element root) Locates elements using a String locator (path) which identifies DOM elements.
java.lang.String	getLegacyPathForElement(Element targetElement) Returns a String locator which uniquely identifies the target element.
java.lang.String	getPathForElement(com.google.gwt.user.client.Element targetElement) Deprecated. As of 7.2, call and override getPathForElement(Element) instead
java.lang.String	getPathForElement(Element targetElement) Generates a String locator which uniquely identifies the target element.
boolean	isValidForLegacyLocator(java.lang.String path) Check if a given selector is valid for LegacyLocatorStrategy.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ComponentLocator

public ComponentLocator(ApplicationConnection client)

Construct a ComponentLocator for the given ApplicationConnection.

Parameters:

client - ApplicationConnection instance for the application.

Method Detail

getPathForElement

@Deprecated
public java.lang.String getPathForElement(com.google.gwt.user.client.Element targetElement)

Deprecated. As of 7.2, call and override getPathForElement(Element) instead

Generates a String locator which uniquely identifies the target element. The getElementByPath(String) method can be used for the inverse operation, i.e. locating an element based on the return value from this method.

Note that getElementByPath(getPathForElement(element)) == element is not always true as #getPathForElement(Element) can return a path to another element if the widget determines an action on the other element will give the same result as the action on the target element.

Parameters:

targetElement - The element to generate a path for.

Returns:

A String locator that identifies the target element or null if a String locator could not be created.

Since:

5.4

getPathForElement

public java.lang.String getPathForElement(Element targetElement)

Generates a String locator which uniquely identifies the target element. The getElementByPath(String) method can be used for the inverse operation, i.e. locating an element based on the return value from this method.

Note that getElementByPath(getPathForElement(element)) == element is not always true as #getPathForElement(Element) can return a path to another element if the widget determines an action on the other element will give the same result as the action on the target element.

Parameters:

targetElement - The element to generate a path for.

Returns:

A String locator that identifies the target element or null if a String locator could not be created.

Since:

7.2

getLegacyPathForElement

public java.lang.String getLegacyPathForElement(Element targetElement)

Returns a String locator which uniquely identifies the target element. The returned locator is in a legacy format that is suitable for Vaadin TestBench Recorder. For non-legacy format, use getPathForElement(com.google.gwt.user.client.Element) instead.

Parameters:

targetElement - The element to generate a path for.

Returns:

A String locator that identifies the target element or null if a String locator could not be created.

Since:

getElementByPath

public com.google.gwt.user.client.Element getElementByPath(java.lang.String path)

Locates an element using a String locator (path) which identifies a DOM element. The getPathForElement(Element) method can be used for the inverse operation, i.e. generating a string expression for a DOM element.

Parameters:

path - The String locator which identifies the target element.

Returns:

The DOM element identified by path or null if the element could not be located.

Since:

5.4

getElementsByPath

public  getElementsByPath(java.lang.String path)

Locates elements using a String locator (path) which identifies DOM elements.

Parameters:

path - The String locator which identifies target elements.

Returns:

The JavaScriptArray of DOM elements identified by path or empty array if elements could not be located.

Since:

7.2

getElementsByPathStartingAt

public  getElementsByPathStartingAt(java.lang.String path,
                                         Element root)

Locates elements using a String locator (path) which identifies DOM elements. The path starts from the specified root element.

Parameters:

path - The path of elements to be found

root - The root element where the path is anchored

Returns:

The JavaScriptArray of DOM elements identified by path or empty array if elements could not be located.

Since:

7.2

See Also:

getElementByPath(String)

getElementByPathStartingAt

public com.google.gwt.user.client.Element getElementByPathStartingAt(java.lang.String path,
                                                                     Element root)

Locates an element using a String locator (path) which identifies a DOM element. The path starts from the specified root element.

Parameters:

path - The path of the element to be found

root - The root element where the path is anchored

Returns:

The DOM element identified by path or null if the element could not be located.

Since:

7.2

See Also:

getElementByPath(String)

getClient

public ApplicationConnection getClient()

Returns the ApplicationConnection used by this locator.

This method is primarily for internal use by the framework.

Returns:

the application connection

isValidForLegacyLocator

public boolean isValidForLegacyLocator(java.lang.String path)

Check if a given selector is valid for LegacyLocatorStrategy.

Parameters:

path - Vaadin selector path

Returns:

true if passes path validation with LegacyLocatorStrategy