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	$(org.openqa.selenium.By seleniumSelector, int index)
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 ShouldableWebElement	assertChecked(org.openqa.selenium.By criteria)
static ShouldableWebElement	assertDisabled(org.openqa.selenium.By criteria)
static ShouldableWebElement	assertElement(org.openqa.selenium.By selector, Condition condition)
static ShouldableWebElement	assertElement(org.openqa.selenium.WebElement element, Condition condition)
static ShouldableWebElement	assertEnabled(org.openqa.selenium.By criteria)
static ShouldableWebElement	assertHidden(org.openqa.selenium.By selector) Method fails if element does not exists.
static ShouldableWebElement	assertNotChecked(org.openqa.selenium.By criteria)
static ShouldableWebElement	assertNotSelected(org.openqa.selenium.By criteria)
static ShouldableWebElement	assertSelected(org.openqa.selenium.By criteria)
static ShouldableWebElement	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 void	confirm(java.lang.String expectedConfirmationText) Accept (Click "Yes" or "Ok") in the confirmation dialog (javascript 'alert' or 'confirm').
static java.lang.String	describeElement(org.openqa.selenium.WebElement element) Deprecated. Use $("selector").toString()
static void	dismiss(java.lang.String expectedConfirmationText) Dismiss (click "No" or "Cancel") in the confirmation dialog (javascript 'alert' or 'confirm').
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 ShouldableWebElement	getElement(org.openqa.selenium.By criteria) Find the first element matching given criteria
static ShouldableWebElement	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 ShouldableWebElement	getSelectedRadio(org.openqa.selenium.By radioField)
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 <PageObjectClass> PageObjectClass	page(java.lang.Class<PageObjectClass> pageObjectClass) Create a Page Object instance.
static <PageObjectClass,T extends PageObjectClass> PageObjectClass	page(T pageObject) Create a Page Object instance.
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 ShouldableWebElement	selectRadio(org.openqa.selenium.By radioField, java.lang.String value) Select radio field by 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 ShouldableWebElement	waitFor(org.openqa.selenium.By elementSelector)
static ShouldableWebElement	waitFor(org.openqa.selenium.By elementSelector, Condition condition) Deprecated.
static ShouldableWebElement	waitFor(org.openqa.selenium.By elementSelector, Condition condition, long timeoutMs) Deprecated.
static ShouldableWebElement	waitFor(org.openqa.selenium.By elementSelector, int index, Condition condition, long timeoutMs) Deprecated.
static ShouldableWebElement	waitFor(java.lang.String cssSelector)
static ShouldableWebElement	waitUntil(org.openqa.selenium.By elementSelector, Condition condition)
static ShouldableWebElement	waitUntil(org.openqa.selenium.By elementSelector, Condition condition, long timeoutMs)
static ShouldableWebElement	waitUntil(org.openqa.selenium.By elementSelector, int index, Condition condition)
static ShouldableWebElement	waitUntil(org.openqa.selenium.By elementSelector, int index, Condition condition, long timeoutMs)
static ShouldableWebElement	waitUntil(java.lang.String cssSelector, Condition condition)
static ShouldableWebElement	waitUntil(java.lang.String cssSelector, Condition condition, long timeoutMs)
static ShouldableWebElement	waitUntil(java.lang.String cssSelector, int index, Condition condition)
static ShouldableWebElement	waitUntil(java.lang.String cssSelector, int index, Condition condition, long timeoutMs)
static ShouldableWebElement	waitUntil(org.openqa.selenium.WebElement parent, org.openqa.selenium.By elementSelector, int index, Condition condition)
static ShouldableWebElement	waitUntil(org.openqa.selenium.WebElement parent, org.openqa.selenium.By elementSelector, int index, Condition condition, long timeoutMs)
static void	waitWhile(org.openqa.selenium.WebElement parent, org.openqa.selenium.By elementSelector, int index, Condition condition)
static void	waitWhile(org.openqa.selenium.WebElement parent, org.openqa.selenium.By elementSelector, int index, Condition condition, long timeoutMs)

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.By seleniumSelector,
                     int index)

See Also:

getElement(By, int)

$

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 - 0..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 - 0..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 ShouldableWebElement getElement(org.openqa.selenium.By criteria)

Find the first element matching given criteria

Parameters:

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

Returns:

ShouldableWebElement

Throws:

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

getElement

public static ShouldableWebElement 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 - 0..N

Returns:

ShouldableWebElement

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 - 0..N

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)

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 ShouldableWebElement selectRadio(org.openqa.selenium.By radioField,
                               java.lang.String value)

Select radio field by value

Parameters:

radioField - any By selector for finding radio field

value - value to select (should match an attribute "value")

Returns:

the selected radio field

getSelectedRadio

public static ShouldableWebElement getSelectedRadio(org.openqa.selenium.By radioField)

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 ShouldableWebElement assertChecked(org.openqa.selenium.By criteria)

assertNotChecked

public static ShouldableWebElement assertNotChecked(org.openqa.selenium.By criteria)

assertDisabled

public static ShouldableWebElement assertDisabled(org.openqa.selenium.By criteria)

assertEnabled

public static ShouldableWebElement assertEnabled(org.openqa.selenium.By criteria)

assertSelected

public static ShouldableWebElement assertSelected(org.openqa.selenium.By criteria)

assertNotSelected

public static ShouldableWebElement assertNotSelected(org.openqa.selenium.By criteria)

isVisible

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

assertVisible

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

assertHidden

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

Method fails if element does not exists.

assertElement

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

assertElement

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

waitFor

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

waitFor

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

waitFor

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

Deprecated.

waitUntil

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

waitUntil

public static ShouldableWebElement waitUntil(java.lang.String cssSelector,
                             Condition condition)

waitUntil

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

waitUntil

public static ShouldableWebElement waitUntil(java.lang.String cssSelector,
                             int index,
                             Condition condition)

waitFor

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

Deprecated.

waitUntil

public static ShouldableWebElement waitUntil(org.openqa.selenium.By elementSelector,
                             Condition condition,
                             long timeoutMs)

waitUntil

public static ShouldableWebElement waitUntil(java.lang.String cssSelector,
                             Condition condition,
                             long timeoutMs)

waitFor

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

Deprecated.

waitUntil

public static ShouldableWebElement waitUntil(java.lang.String cssSelector,
                             int index,
                             Condition condition,
                             long timeoutMs)

waitUntil

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

waitUntil

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

waitUntil

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

waitWhile

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

waitWhile

public static void waitWhile(org.openqa.selenium.WebElement parent,
             org.openqa.selenium.By elementSelector,
             int index,
             Condition condition,
             long timeoutMs)

confirm

public static void confirm(java.lang.String expectedConfirmationText)

Accept (Click "Yes" or "Ok") in the confirmation dialog (javascript 'alert' or 'confirm'). Method does nothing in case of HtmlUnit browser (since HtmlUnit does not support alerts).

Parameters:

expectedConfirmationText - if not null, check that confirmation dialog displays this message (case-sensitive)

Throws:

java.lang.AssertionError - if confirmation message differs from expected message

dismiss

public static void dismiss(java.lang.String expectedConfirmationText)

Dismiss (click "No" or "Cancel") in the confirmation dialog (javascript 'alert' or 'confirm'). Method does nothing in case of HtmlUnit browser (since HtmlUnit does not support alerts).

Parameters:

expectedConfirmationText - if not null, check that confirmation dialog displays this message (case-sensitive)

Throws:

java.lang.AssertionError - if confirmation message differs from expected message

describeElement

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

Deprecated. Use $("selector").toString()

page

public static <PageObjectClass> PageObjectClass page(java.lang.Class<PageObjectClass> pageObjectClass)

Create a Page Object instance.

See Also:

PageFactory.initElements(org.openqa.selenium.WebDriver, java.lang.Class)

page

public static <PageObjectClass,T extends PageObjectClass> PageObjectClass page(T pageObject)

Create a Page Object instance.

See Also:

PageFactory.initElements(org.openqa.selenium.WebDriver, java.lang.Class)