com.codeborne.selenide

Class Selectors

java.lang.Object

com.codeborne.selenide.Selectors

@ParametersAreNonnullByDefault
public class Selectors
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Selectors()

Method Summary

Modifier and Type	Method and Description
static org.openqa.selenium.By	by(java.lang.String attributeName, java.lang.String attributeValue) Synonym for #byAttribute
static org.openqa.selenium.By	byAttribute(java.lang.String attributeName, java.lang.String attributeValue) Find elements having attribute with given value.
static org.openqa.selenium.By	byClassName(java.lang.String className)
static org.openqa.selenium.By	byCssSelector(java.lang.String css)
static org.openqa.selenium.By	byId(java.lang.String id)
static org.openqa.selenium.By	byLinkText(java.lang.String linkText)
static org.openqa.selenium.By	byName(java.lang.String name)
static org.openqa.selenium.By	byPartialLinkText(java.lang.String partialLinkText)
static org.openqa.selenium.By	byTagAndText(java.lang.String tag, java.lang.String elementText) Find element that has given text (the whole text, not a substring).
static org.openqa.selenium.By	byTagName(java.lang.String tagName)
static org.openqa.selenium.By	byText(java.lang.String elementText) Find element that has given text (the whole text, not a substring).
static org.openqa.selenium.By	byTextCaseInsensitive(java.lang.String elementText) Same as byText(String), but case-insensitive.
static org.openqa.selenium.By	byTitle(java.lang.String title) Find element with given title ("title" attribute)
static org.openqa.selenium.By	byValue(java.lang.String value) Find input element with given value ("value" attribute)
static org.openqa.selenium.By	byXpath(java.lang.String xpath)
static org.openqa.selenium.By	shadowCss(java.lang.String target, java.lang.String shadowHost, java.lang.String... innerShadowHosts)
static org.openqa.selenium.By	withTagAndText(java.lang.String tag, java.lang.String elementText) Find element CONTAINING given text (as a substring).
static org.openqa.selenium.By	withText(java.lang.String elementText) Find element CONTAINING given text (as a substring).
static org.openqa.selenium.By	withTextCaseInsensitive(java.lang.String elementText) Same as withText(String), but case-insensitive.

Methods inherited from class java.lang.Object

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

Constructor Detail

Selectors

public Selectors()

Method Detail

withText

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By withText(java.lang.String elementText)

Find element CONTAINING given text (as a substring).

This method ignores difference between space, \n, \r, \t and This method ignores multiple spaces.

Parameters:

elementText - Text to search inside element

Returns:

standard selenium By criteria`

withTagAndText

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By withTagAndText(java.lang.String tag,
                                                                                java.lang.String elementText)

Find element CONTAINING given text (as a substring).

This method ignores difference between space, \n, \r, \t and This method ignores multiple spaces.

Parameters:

tag - Html tag name (e.g. "dev", "span", "li", "a", "td")

elementText - Text to search inside element

Returns:

standard selenium By criteria`

Since:

6.3.0

withTextCaseInsensitive

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By withTextCaseInsensitive(java.lang.String elementText)

Same as withText(String), but case-insensitive.

Since:

5.22.0

byText

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byText(java.lang.String elementText)

Find element that has given text (the whole text, not a substring).

This method ignores difference between space, \n, \r, \t and This method ignores multiple spaces. This method is case-sensitive.

Parameters:

elementText - Text that searched element should have

Returns:

standard selenium By criteria

byTagAndText

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byTagAndText(java.lang.String tag,
                                                                              java.lang.String elementText)

Find element that has given text (the whole text, not a substring).

This method ignores difference between space, \n, \r, \t and This method ignores multiple spaces. This method is case-sensitive.

Parameters:

tag - Html tag name (e.g. "dev", "span", "li", "a", "td")

elementText - Text that searched element should have

Returns:

standard selenium By criteria

Since:

6.3.0

byTextCaseInsensitive

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byTextCaseInsensitive(java.lang.String elementText)

Same as byText(String), but case-insensitive.

Since:

5.22.0

byAttribute

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byAttribute(java.lang.String attributeName,
                                                                             java.lang.String attributeValue)

Find elements having attribute with given value.

Examples: <div binding="fieldValue"></div> Find element with attribute 'binding' EXACTLY containing text 'fieldValue' , use: byAttribute("binding", "fieldValue")

For finding difficult/generated data attribute which contains some value: <div binding="userName17fk5n6kc2Ds45F40d0fieldValue_promoLanding word"></div>

Find element with attribute 'binding' CONTAINING text 'fieldValue', use symbol '*' with attribute name: byAttribute("binding*", "fieldValue") it same as By.cssSelector("[binding*='fieldValue']")

Find element whose attribute 'binding' BEGINS with 'userName', use symbol '^' with attribute name: byAttribute("binding^", "fieldValue")

Find element whose attribute 'binding' ENDS with 'promoLanding', use symbol '$' with attribute name: byAttribute("binding$", "promoLanding")

Find element whose attribute 'binding' CONTAINING WORD 'word': byAttribute("binding~", "word")

Seems to work incorrectly if attribute name contains dash, for example: <option data-mailServerId="123"></option>

Parameters:

attributeName - name of attribute, should not be empty or null

attributeValue - value of attribute, should not contain both apostrophes and quotes

Returns:

standard selenium By cssSelector criteria

shadowCss

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By shadowCss(java.lang.String target,
                                                                           java.lang.String shadowHost,
                                                                           java.lang.String... innerShadowHosts)

Since:

5.10

See Also:

ByShadow.cssSelector(java.lang.String, java.lang.String, java.lang.String...)

by

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By by(java.lang.String attributeName,
                                                                    java.lang.String attributeValue)

Synonym for #byAttribute

byTitle

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byTitle(java.lang.String title)

Find element with given title ("title" attribute)

byValue

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byValue(java.lang.String value)

Find input element with given value ("value" attribute)

byName

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byName(java.lang.String name)

Since:

3.1

See Also:

By.name(java.lang.String)

byXpath

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byXpath(java.lang.String xpath)

Since:

3.1

See Also:

By.xpath(java.lang.String)

byLinkText

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byLinkText(java.lang.String linkText)

Since:

3.1

See Also:

By.linkText(java.lang.String)

byPartialLinkText

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byPartialLinkText(java.lang.String partialLinkText)

Since:

3.1

See Also:

By.partialLinkText(java.lang.String)

byId

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byId(java.lang.String id)

Since:

3.1

See Also:

By.id(java.lang.String)

byCssSelector

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byCssSelector(java.lang.String css)

Since:

3.8

See Also:

By.cssSelector(java.lang.String)

byClassName

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byClassName(java.lang.String className)

Since:

3.8

See Also:

By.className(java.lang.String)

byTagName

@CheckReturnValue
 @Nonnull
public static org.openqa.selenium.By byTagName(java.lang.String tagName)

Since:

5.11

See Also:

By.tagName(java.lang.String)