com.vaadin.testbench.HasElementQuery Maven / Gradle / Ivy
/**
* Copyright (C) 2000-2022 Vaadin Ltd
*
* This program is available under Vaadin Commercial License and Service Terms.
*
* See for the full
* license.
*/
package com.vaadin.testbench;
public interface HasElementQuery extends HasSearchContext {
/**
* Prepare a {@link ElementQuery} instance to use for locating components on
* the client. The returned object can be manipulated to uniquely identify
* the sought-after object. If this function gets called through an element,
* it uses the element as its search context. Otherwise the search context
* is the driver.
*
* @param
* the type of the queried {@link TestBenchElement}
* @param clazz
* the type of element to find, with the tag name defined using
* @Element on the class
* @return an appropriate {@link ElementQuery} instance
*/
public default ElementQuery $(
Class clazz) {
return new ElementQuery<>(clazz).context(getContext());
}
/**
* Prepare a {@link ElementQuery} instance to use for locating components on
* the client. The returned object can be manipulated to uniquely identify
* the sought-after object. If this function gets called through an element,
* it uses the element as its search context. Otherwise the search context
* is the driver.
*
* @param tagName
* the tag name of the element to find
* @return an appropriate {@link ElementQuery} instance
*/
public default ElementQuery $(String tagName) {
return new ElementQuery<>(TestBenchElement.class, tagName)
.context(getContext());
}
}