com.codeborne.selenide

Class Selenide

java.lang.Object

com.codeborne.selenide.Selenide

public class Selenide
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static Navigator	navigator

Constructor Summary

Constructors

Constructor and Description
Selenide()

Method Summary

Methods

Modifier and Type	Method and Description
static SelenideElement	$(org.openqa.selenium.By seleniumSelector) Find the first element matching given CSS selector
static SelenideElement	$(org.openqa.selenium.By seleniumSelector, int index)
static SelenideElement	$(java.lang.String cssSelector) Find the first element matching given CSS selector
static SelenideElement	$(java.lang.String cssSelector, int index) Find the Nth element matching given criteria
static SelenideElement	$(org.openqa.selenium.WebElement webElement) Wrap standard Selenium WebElement into SelenideElement to use additional methods like shouldHave(), selectOption() etc.
protected static SelenideElement	$(org.openqa.selenium.WebElement parent, org.openqa.selenium.By selector, int index)
static SelenideElement	$(org.openqa.selenium.WebElement parent, java.lang.String cssSelector) Find the first element matching given CSS selector
static SelenideElement	$(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.util.Collection<? extends org.openqa.selenium.WebElement> elements)
static ElementsCollection	$$(java.lang.String cssSelector) Find all elements matching given CSS selector.
static ElementsCollection	$$(org.openqa.selenium.WebElement parent, org.openqa.selenium.By seleniumSelector) Find all elements matching given criteria inside given parent element
static ElementsCollection	$$(org.openqa.selenium.WebElement parent, java.lang.String cssSelector) Find all elements matching given CSS selector inside given parent element 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.
static org.openqa.selenium.interactions.Actions	actions() With this method you can use Selenium Actions like described in the AdvancedUserInteractions page.
static void	confirm(java.lang.String expectedConfirmationText) Accept (Click "Yes" or "Ok") in the confirmation dialog (javascript 'alert' or 'confirm').
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 SelenideElement	getElement(org.openqa.selenium.By criteria) Find the first element matching given criteria
static SelenideElement	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 org.openqa.selenium.WebElement	getFocusedElement()
static SelenideElement	getSelectedRadio(org.openqa.selenium.By radioField)
static void	open(java.lang.String relativeOrAbsoluteUrl)
static <PageObjectClass> PageObjectClass	open(java.lang.String relativeOrAbsoluteUrl, java.lang.Class<PageObjectClass> pageObjectClassClass)
static void	open(java.net.URL absoluteUrl)
static <PageObjectClass> PageObjectClass	open(java.net.URL absoluteUrl, java.lang.Class<PageObjectClass> pageObjectClassClass)
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	refresh() Reload current page
static SelenideElement	selectRadio(org.openqa.selenium.By radioField, java.lang.String value) Select radio field by value
static void	sleep(long milliseconds) Not recommended.
static org.openqa.selenium.WebDriver.TargetLocator	switchTo()
static java.lang.String	title()
static org.openqa.selenium.support.ui.FluentWait<org.openqa.selenium.WebDriver>	Wait()

Methods inherited from class java.lang.Object

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

Field Detail

navigator

public static Navigator navigator

Constructor Detail

Selenide

public Selenide()

Method Detail

open

public static void open(java.lang.String relativeOrAbsoluteUrl)

open

public static void open(java.net.URL absoluteUrl)

open

public static <PageObjectClass> PageObjectClass open(java.lang.String relativeOrAbsoluteUrl,
                                     java.lang.Class<PageObjectClass> pageObjectClassClass)

open

public static <PageObjectClass> PageObjectClass open(java.net.URL absoluteUrl,
                                     java.lang.Class<PageObjectClass> pageObjectClassClass)

refresh

public static void refresh()

Reload current page

title

public static java.lang.String title()

sleep

public static void sleep(long milliseconds)

Not recommended. Test should not sleep, but should wait for some condition instead.

Parameters:

milliseconds - Time to sleep in milliseconds

$

public static SelenideElement $(org.openqa.selenium.WebElement webElement)

Wrap standard Selenium WebElement into SelenideElement to use additional methods like shouldHave(), selectOption() etc.

Parameters:

webElement - standard Selenium WebElement

Returns:

given WebElement wrapped into SelenideElement

$

public static SelenideElement $(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:

SelenideElement

Throws:

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

$

public static SelenideElement $(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:

SelenideElement

Throws:

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

$

public static SelenideElement $(org.openqa.selenium.By seleniumSelector,
                int index)

See Also:

getElement(org.openqa.selenium.By, int)

$

public static SelenideElement $(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:

SelenideElement

Throws:

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

$

public static SelenideElement $(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:

SelenideElement

Throws:

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

$

public static SelenideElement $(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:

SelenideElement

Throws:

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

$

protected static SelenideElement $(org.openqa.selenium.WebElement parent,
                org.openqa.selenium.By selector,
                int index)

$$

public static ElementsCollection $$(java.util.Collection<? extends org.openqa.selenium.WebElement> elements)

$$

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 inside given parent element 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

$$

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

Find all elements matching given criteria inside given parent element

See Also:

$$(org.openqa.selenium.WebElement, String)

getElement

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

Find the first element matching given criteria

Parameters:

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

Returns:

SelenideElement

Throws:

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

getElement

public static SelenideElement 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:

SelenideElement

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

executeJavaScript

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

selectRadio

public static SelenideElement 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 SelenideElement getSelectedRadio(org.openqa.selenium.By radioField)

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

switchTo

public static org.openqa.selenium.WebDriver.TargetLocator switchTo()

getFocusedElement

public static org.openqa.selenium.WebElement getFocusedElement()

page

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

Create a Page Object instance.

See Also:

PageFactory.initElements(org.openqa.selenium.WebDriver, 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, Class)

Wait

public static org.openqa.selenium.support.ui.FluentWait<org.openqa.selenium.WebDriver> Wait()

actions

public static org.openqa.selenium.interactions.Actions actions()

With this method you can use Selenium Actions like described in the AdvancedUserInteractions page.

   actions()
    .sendKeys($(By.name("rememberMe")), "John")
    .click($(#rememberMe"))
    .click($(byText("Login")))
    .build()
    .perform();