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	close() Close the browser if it's open
static void	confirm(java.lang.String expectedDialogText) Accept (Click "Yes" or "Ok") in the confirmation dialog (javascript 'alert' or 'confirm').
static void	dismiss(java.lang.String expectedDialogText) 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	onConfirmReturn(boolean confirmReturnValue)
static void	open(java.lang.String relativeOrAbsoluteUrl) The main starting point in your tests.
static <PageObjectClass> PageObjectClass	open(java.lang.String relativeOrAbsoluteUrl, java.lang.Class<PageObjectClass> pageObjectClassClass) Open a web page and create PageObject for it.
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 java.lang.String	screenshot(java.lang.String fileName) Take the screenshot of current page and save to file fileName.html and fileName.png
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)

The main starting point in your tests. Open a browser window with given URL. If browser window was already opened before, it will be reused. Don't bother about closing the browser - it will be closed automatically when all your tests are done.

Parameters:

relativeOrAbsoluteUrl - If starting with "http://" or "https://" or "file://", it's considered to be relative URL. In this case, it's prepended by baseUrl

open

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

See Also:

open(java.lang.String)

open

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

Open a web page and create PageObject for it.

Returns:

PageObject of given class

open

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

close

public static void close()

Close the browser if it's open

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

screenshot

public static java.lang.String screenshot(java.lang.String fileName)

Take the screenshot of current page and save to file fileName.html and fileName.png

Parameters:

fileName - Name of file (without extension) to save HTML and PNG to

Returns:

The name of resulting file

$

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)

onConfirmReturn

public static void onConfirmReturn(boolean confirmReturnValue)

confirm

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

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:

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

Throws:

DialogTextMismatch - if confirmation message differs from expected message

dismiss

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

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:

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

Throws:

DialogTextMismatch - 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();