com.codeborne.selenide

Class DOM

java.lang.Object

com.codeborne.selenide.DOM

public class DOM
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static long	defaultWaitingTimeout

Constructor Summary

Constructors

Constructor and Description
DOM()

Method Summary

Methods

Modifier and Type	Method and Description
static ShouldableWebElement	$(org.openqa.selenium.By seleniumSelector) Find the first element matching given CSS selector
static ShouldableWebElement	$(java.lang.String cssSelector) Find the first element matching given CSS selector
static ShouldableWebElement	$(java.lang.String cssSelector, int index) Find the Nth element matching given criteria
static ShouldableWebElement	$(org.openqa.selenium.WebElement parent, java.lang.String cssSelector) Find the first element matching given CSS selector
static ShouldableWebElement	$(org.openqa.selenium.WebElement parent, java.lang.String cssSelector, int index) Find the Nth element matching given criteria
static ElementsCollection	$$(org.openqa.selenium.By seleniumSelector) Find all elements matching given CSS selector.
static ElementsCollection	$$(java.lang.String cssSelector) Find all elements matching given CSS selector.
static ElementsCollection	$$(org.openqa.selenium.WebElement parent, java.lang.String cssSelector) Find all elements matching given CSS selector.
static void	assertChecked(org.openqa.selenium.By element)
static void	assertDisabled(org.openqa.selenium.By element)
static org.openqa.selenium.WebElement	assertElement(org.openqa.selenium.By selector, Condition condition)
static org.openqa.selenium.WebElement	assertElement(org.openqa.selenium.WebElement element, Condition condition)
static void	assertEnabled(org.openqa.selenium.By element)
static org.openqa.selenium.WebElement	assertHidden(org.openqa.selenium.By selector) Method fails if element does not exists.
static void	assertNotChecked(org.openqa.selenium.By element)
static void	assertNotSelected(org.openqa.selenium.By element)
static void	assertSelected(org.openqa.selenium.By element)
static org.openqa.selenium.WebElement	assertVisible(org.openqa.selenium.By selector)
static void	callOnClick(org.openqa.selenium.By by) Calls onclick javascript code, useful for invisible (hovered) elements that cannot be clicked directly
static void	click(org.openqa.selenium.By by)
static void	click(org.openqa.selenium.By by, int index) Click the Nth matched element on the page.
static java.lang.String	describeElement(org.openqa.selenium.WebElement element)
static java.lang.Object	executeJavaScript(java.lang.String jsCode)
static boolean	existsAndVisible(org.openqa.selenium.By selector)
static void	followLink(org.openqa.selenium.By by)
static org.openqa.selenium.WebElement	getElement(org.openqa.selenium.By criteria) Find the first element matching given criteria
static org.openqa.selenium.WebElement	getElement(org.openqa.selenium.By criteria, int index) Find the Nth element matching given criteria
static ElementsCollection	getElements(org.openqa.selenium.By criteria) Find all elements matching given CSS selector
static java.lang.String	getJQuerySelector(org.openqa.selenium.By seleniumSelector)
static java.lang.String	getJQuerySelectorString(org.openqa.selenium.By seleniumSelector)
static java.lang.String	getSelectedText(org.openqa.selenium.By selectField)
static java.lang.String	getSelectedValue(org.openqa.selenium.By selectField)
static boolean	isJQueryAvailable()
static boolean	isVisible(org.openqa.selenium.By selector)
static void	scrollTo(org.openqa.selenium.By element) It works only if jQuery "scroll" plugin is included in page being tested
static org.openqa.selenium.support.ui.Select	select(org.openqa.selenium.By selectField)
static void	selectOption(org.openqa.selenium.By selectField, java.lang.String value)
static void	selectOptionByText(org.openqa.selenium.By selectField, java.lang.String text)
static org.openqa.selenium.WebElement	selectRadio(org.openqa.selenium.By radioField, java.lang.String value)
static void	setValue(org.openqa.selenium.By by, int index, java.lang.String value)
static void	setValue(org.openqa.selenium.By by, java.lang.String value)
static void	setValue(org.openqa.selenium.WebElement element, java.lang.String value)
static void	triggerChangeEvent(org.openqa.selenium.By by)
static void	triggerChangeEvent(org.openqa.selenium.By by, int index)
static org.openqa.selenium.WebElement	waitFor(org.openqa.selenium.By elementSelector)
static org.openqa.selenium.WebElement	waitFor(org.openqa.selenium.By elementSelector, Condition condition) Deprecated.
static org.openqa.selenium.WebElement	waitFor(org.openqa.selenium.By elementSelector, Condition condition, long milliseconds) Deprecated.
static org.openqa.selenium.WebElement	waitFor(org.openqa.selenium.By elementSelector, int index, Condition condition, long milliseconds) Deprecated.
static org.openqa.selenium.WebElement	waitUntil(org.openqa.selenium.By elementSelector, Condition condition)
static org.openqa.selenium.WebElement	waitUntil(org.openqa.selenium.By elementSelector, Condition condition, long milliseconds)
static org.openqa.selenium.WebElement	waitUntil(org.openqa.selenium.By elementSelector, int index, Condition condition)
static org.openqa.selenium.WebElement	waitUntil(org.openqa.selenium.By elementSelector, int index, Condition condition, long milliseconds)

Methods inherited from class java.lang.Object

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

Field Detail

defaultWaitingTimeout

public static long defaultWaitingTimeout

Constructor Detail

DOM

public DOM()

Method Detail

$

public static ShouldableWebElement $(java.lang.String cssSelector)

Find the first element matching given CSS selector

Parameters:

cssSelector - any CSS selector like "input[name='first_name']" or "#messages .new_message"

Returns:

ShouldableWebElement

Throws:

org.openqa.selenium.NoSuchElementException - if element was no found

$

public static ShouldableWebElement $(org.openqa.selenium.By seleniumSelector)

Find the first element matching given CSS selector

Parameters:

seleniumSelector - any Selenium selector like By.id(), By.name() etc.

Returns:

ShouldableWebElement

Throws:

org.openqa.selenium.NoSuchElementException - if element was no found

$

public static ShouldableWebElement $(org.openqa.selenium.WebElement parent,
                     java.lang.String cssSelector)

Find the first element matching given CSS selector

Parameters:

parent - the WebElement to search elements in

cssSelector - any CSS selector like "input[name='first_name']" or "#messages .new_message"

Returns:

ShouldableWebElement

Throws:

org.openqa.selenium.NoSuchElementException - if element was no found

$

public static ShouldableWebElement $(java.lang.String cssSelector,
                     int index)

Find the Nth element matching given criteria

Parameters:

cssSelector - any CSS selector like "input[name='first_name']" or "#messages .new_message"

index - 1..N

Returns:

ShouldableWebElement

Throws:

org.openqa.selenium.NoSuchElementException - if element was no found

$

public static ShouldableWebElement $(org.openqa.selenium.WebElement parent,
                     java.lang.String cssSelector,
                     int index)

Find the Nth element matching given criteria

Parameters:

parent - the WebElement to search elements in

cssSelector - any CSS selector like "input[name='first_name']" or "#messages .new_message"

index - 1..N

Returns:

ShouldableWebElement

Throws:

org.openqa.selenium.NoSuchElementException - if element was no found

$$

public static ElementsCollection $$(java.lang.String cssSelector)

Find all elements matching given CSS selector. Methods returns an ElementsCollection which is a list of WebElement objects that can be iterated, and at the same time is implementation of WebElement interface, meaning that you can call methods .sendKeys(), click() etc. on it.

Parameters:

cssSelector - any CSS selector like "input[name='first_name']" or "#messages .new_message"

Returns:

empty list if element was no found

$$

public static ElementsCollection $$(org.openqa.selenium.By seleniumSelector)

Find all elements matching given CSS selector. Methods returns an ElementsCollection which is a list of WebElement objects that can be iterated, and at the same time is implementation of WebElement interface, meaning that you can call methods .sendKeys(), click() etc. on it.

Parameters:

seleniumSelector - any Selenium selector like By.id(), By.name() etc.

Returns:

empty list if element was no found

$$

public static ElementsCollection $$(org.openqa.selenium.WebElement parent,
                    java.lang.String cssSelector)

Find all elements matching given CSS selector. Methods returns an ElementsCollection which is a list of WebElement objects that can be iterated, and at the same time is implementation of WebElement interface, meaning that you can call methods .sendKeys(), click() etc. on it.

Parameters:

parent - the WebElement to search elements in

cssSelector - any CSS selector like "input[name='first_name']" or "#messages .new_message"

Returns:

empty list if element was no found

getElement

public static org.openqa.selenium.WebElement getElement(org.openqa.selenium.By criteria)

Find the first element matching given criteria

Parameters:

criteria - instance of By: By.id(), By.className() etc.

Returns:

WebElement

Throws:

org.openqa.selenium.NoSuchElementException - if element was no found

getElement

public static org.openqa.selenium.WebElement getElement(org.openqa.selenium.By criteria,
                                        int index)

Find the Nth element matching given criteria

Parameters:

criteria - instance of By: By.id(), By.className() etc.

index - 1..N

Returns:

WebElement

Throws:

org.openqa.selenium.NoSuchElementException - if element was no found

getElements

public static ElementsCollection getElements(org.openqa.selenium.By criteria)

Find all elements matching given CSS selector

Parameters:

criteria - instance of By: By.id(), By.className() etc.

Returns:

empty list if element was no found

setValue

public static void setValue(org.openqa.selenium.By by,
            java.lang.String value)

setValue

public static void setValue(org.openqa.selenium.By by,
            int index,
            java.lang.String value)

setValue

public static void setValue(org.openqa.selenium.WebElement element,
            java.lang.String value)

isJQueryAvailable

public static boolean isJQueryAvailable()

click

public static void click(org.openqa.selenium.By by)

callOnClick

public static void callOnClick(org.openqa.selenium.By by)

Calls onclick javascript code, useful for invisible (hovered) elements that cannot be clicked directly

click

public static void click(org.openqa.selenium.By by,
         int index)

Click the Nth matched element on the page.

Parameters:

by - selector to match element

index - is zero-based

Throws:

java.lang.IllegalArgumentException - if index is bigger than number of matched elements.

triggerChangeEvent

public static void triggerChangeEvent(org.openqa.selenium.By by)

triggerChangeEvent

public static void triggerChangeEvent(org.openqa.selenium.By by,
                      int index)

getJQuerySelector

public static java.lang.String getJQuerySelector(org.openqa.selenium.By seleniumSelector)

getJQuerySelectorString

public static java.lang.String getJQuerySelectorString(org.openqa.selenium.By seleniumSelector)

describeElement

public static java.lang.String describeElement(org.openqa.selenium.WebElement element)

executeJavaScript

public static java.lang.Object executeJavaScript(java.lang.String jsCode)

scrollTo

public static void scrollTo(org.openqa.selenium.By element)

It works only if jQuery "scroll" plugin is included in page being tested

Parameters:

element - HTML element to scroll to.

selectRadio

public static org.openqa.selenium.WebElement selectRadio(org.openqa.selenium.By radioField,
                                         java.lang.String value)

getSelectedValue

public static java.lang.String getSelectedValue(org.openqa.selenium.By selectField)

getSelectedText

public static java.lang.String getSelectedText(org.openqa.selenium.By selectField)

select

public static org.openqa.selenium.support.ui.Select select(org.openqa.selenium.By selectField)

selectOption

public static void selectOption(org.openqa.selenium.By selectField,
                java.lang.String value)

selectOptionByText

public static void selectOptionByText(org.openqa.selenium.By selectField,
                      java.lang.String text)

existsAndVisible

public static boolean existsAndVisible(org.openqa.selenium.By selector)

followLink

public static void followLink(org.openqa.selenium.By by)

assertChecked

public static void assertChecked(org.openqa.selenium.By element)

assertNotChecked

public static void assertNotChecked(org.openqa.selenium.By element)

assertDisabled

public static void assertDisabled(org.openqa.selenium.By element)

assertEnabled

public static void assertEnabled(org.openqa.selenium.By element)

assertSelected

public static void assertSelected(org.openqa.selenium.By element)

assertNotSelected

public static void assertNotSelected(org.openqa.selenium.By element)

isVisible

public static boolean isVisible(org.openqa.selenium.By selector)

assertVisible

public static org.openqa.selenium.WebElement assertVisible(org.openqa.selenium.By selector)

assertHidden

public static org.openqa.selenium.WebElement assertHidden(org.openqa.selenium.By selector)

Method fails if element does not exists.

assertElement

public static org.openqa.selenium.WebElement assertElement(org.openqa.selenium.By selector,
                                           Condition condition)

assertElement

public static org.openqa.selenium.WebElement assertElement(org.openqa.selenium.WebElement element,
                                           Condition condition)

waitFor

public static org.openqa.selenium.WebElement waitFor(org.openqa.selenium.By elementSelector)

waitFor

@Deprecated
public static org.openqa.selenium.WebElement waitFor(org.openqa.selenium.By elementSelector,
                                                Condition condition)

Deprecated.

waitUntil

public static org.openqa.selenium.WebElement waitUntil(org.openqa.selenium.By elementSelector,
                                       Condition condition)

waitUntil

public static org.openqa.selenium.WebElement waitUntil(org.openqa.selenium.By elementSelector,
                                       int index,
                                       Condition condition)

waitFor

@Deprecated
public static org.openqa.selenium.WebElement waitFor(org.openqa.selenium.By elementSelector,
                                                Condition condition,
                                                long milliseconds)

Deprecated.

waitUntil

public static org.openqa.selenium.WebElement waitUntil(org.openqa.selenium.By elementSelector,
                                       Condition condition,
                                       long milliseconds)

waitFor

@Deprecated
public static org.openqa.selenium.WebElement waitFor(org.openqa.selenium.By elementSelector,
                                                int index,
                                                Condition condition,
                                                long milliseconds)

Deprecated.

waitUntil

public static org.openqa.selenium.WebElement waitUntil(org.openqa.selenium.By elementSelector,
                                       int index,
                                       Condition condition,
                                       long milliseconds)