Selenide (selenide-RELEASE 3.4 API)

java.lang.Object
- com.codeborne.selenide.Selenide

```
public class Selenide
extends java.lang.Object
```
The main starting point of Selenide. You start with methods open(String) for opening the tested application page and $(String) for searching web elements.

Field Summary

Fields
Modifier and Type Field and Description

static Navigator navigator

Fields
Modifier and Type	Field and Description
`static Navigator`	`navigator`

Constructor Summary

Constructors
Constructor and Description

Selenide()

Constructors
Constructor and Description
`Selenide()`

Method Summary

All Methods Static Methods Concrete Methods Deprecated 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.
`static SelenideElement`	`$(org.openqa.selenium.WebElement parent, org.openqa.selenium.By seleniumSelector)` Deprecated. please use $(parent).$(By) which is the same (method will not be removed until 4.x or later)
`static SelenideElement`	`$(org.openqa.selenium.WebElement parent, org.openqa.selenium.By seleniumSelector, int index)` Deprecated. please use $(parent).$(By, int) which is the same (method will not be removed until 4.x or later)
`static SelenideElement`	`$(org.openqa.selenium.WebElement parent, java.lang.String cssSelector)` Deprecated. please use $(parent).$(String) which is the same (method will not be removed until 4.x or later)
`static SelenideElement`	`$(org.openqa.selenium.WebElement parent, java.lang.String cssSelector, int index)` Deprecated. please use $(parent).$(String, int) which is the same (method will not be removed until 4.x or later)
`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)` Initialize collection with 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)` Deprecated. please use $(parent).$$(By) which is the same (method will not be removed until 4.x or later)
`static ElementsCollection`	`$$(org.openqa.selenium.WebElement parent, java.lang.String cssSelector)` Deprecated. please use $(parent).$$(String) which is the same (method will not be removed until 4.x or later)
`static org.openqa.selenium.interactions.Actions`	`actions()` With this method you can use Selenium Actions like described in the AdvancedUserInteractions page.
`static void`	`assertNoJavascriptErrors()` Check if there is not JS errors on the page
`static void`	`back()` Navigate browser back to previous page
`static void`	`close()` Close the browser if it's open
`static java.lang.String`	`confirm()` Accept (Click "Yes" or "Ok") in the confirmation dialog (javascript 'alert' or 'confirm').
`static java.lang.String`	`confirm(java.lang.String expectedDialogText)` Accept (Click "Yes" or "Ok") in the confirmation dialog (javascript 'alert' or 'confirm').
`static java.lang.String`	`dismiss()` Dismiss (click "No" or "Cancel") in the confirmation dialog (javascript 'alert' or 'confirm').
`static java.lang.String`	`dismiss(java.lang.String expectedDialogText)` Dismiss (click "No" or "Cancel") in the confirmation dialog (javascript 'alert' or 'confirm').
`static <T> T`	`executeJavaScript(java.lang.String jsCode, java.lang.Object... arguments)` Executes JavaScript
`static void`	`forward()` Navigate browser forward to next page
`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 java.util.List<java.lang.String>`	`getJavascriptErrors()` Get JavaScript errors that happened on this page.
`static SelenideElement`	`getSelectedRadio(org.openqa.selenium.By radioField)` Returns selected element in radio group
`static java.util.List<java.lang.String>`	`getWebDriverLogs(java.lang.String logType)` Same as com.codeborne.selenide.Selenide#getWebDriverLogs(java.lang.String, java.util.logging.Level)
`static java.util.List<java.lang.String>`	`getWebDriverLogs(java.lang.String logType, java.util.logging.Level logLevel)` Getting and filtering of the WebDriver logs for specified LogType by specified logging level For example to get WebDriver Browser's console output (including JS info, warnings, errors, etc.
`static void`	`onConfirmReturn(boolean confirmReturnValue)` Mock confirm dialog that return given value
`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)` Open a web page and create PageObject for it.
`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)` Not recommended.
`static void`	`sleep(long milliseconds)` Not recommended.
`static SelenideTargetLocator`	`switchTo()` Switch to window/tab/frame/parentFrame/innerFrame/alert.
`static java.lang.String`	`title()`
`static void`	`updateHash(java.lang.String hash)` Update the hash of the window location.
`static org.openqa.selenium.support.ui.FluentWait<org.openqa.selenium.WebDriver>`	`Wait()` Create a org.openqa.selenium.support.ui.FluentWait instance with Selenide timeout/polling.
`static void`	`zoom(double factor)` Zoom current page (in or out).

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 not 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(String)
  - updateHash
```
public static void updateHash(java.lang.String hash)
```
    Update the hash of the window location. Useful to navigate in ajax apps without reloading the page, since open(url) makes a full page reload.
    
    Parameters:
    
    hash - value for window.location.hash - Accept either "#hash" or "hash".
  - 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)
```
    Open a web page and create PageObject for it.
    
    Returns:
    
    PageObject of given class
  - close
```
public static void close()
```
    Close the browser if it's open
  - refresh
```
public static void refresh()
```
    Reload current page
  - back
```
public static void back()
```
    Navigate browser back to previous page
  - forward
```
public static void forward()
```
    Navigate browser forward to next page
  - title
```
public static java.lang.String title()
```
    Returns:
    
    title of the page
  - 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
  - $
```
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
  - $
```
public static SelenideElement $(org.openqa.selenium.By seleniumSelector,
                                int index)
```
    See Also:
    
    getElement(By, int)
  - $
```
@Deprecated
public static SelenideElement $(org.openqa.selenium.WebElement parent,
                                            java.lang.String cssSelector)
```
    Deprecated. please use $(parent).$(String) which is the same (method will not be removed until 4.x or later)
    
    Parameters:
    
    parent - the WebElement to search elements in
    
    cssSelector - any CSS selector like "input[name='first_name']" or "#messages .new_message"
    
    Returns:
    
    SelenideElement
    
    See Also:
    
    Find the first element matching given CSS selector
  - $
```
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
  - $
```
@Deprecated
public static SelenideElement $(org.openqa.selenium.WebElement parent,
                                            java.lang.String cssSelector,
                                            int index)
```
    Deprecated. please use $(parent).$(String, int) which is the same (method will not be removed until 4.x or later)
    
    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
    
    See Also:
    
    Find the Nth element matching given criteria
  - $
```
@Deprecated
public static SelenideElement $(org.openqa.selenium.WebElement parent,
                                            org.openqa.selenium.By seleniumSelector)
```
    Deprecated. please use $(parent).$(By) which is the same (method will not be removed until 4.x or later)
    
    Parameters:
    
    parent - the WebElement to search elements in
    
    seleniumSelector - any Selenium selector like By.id(), By.name() etc.
    
    Returns:
    
    SelenideElement
    
    See Also:
    
    Find the first element matching given criteria
  - $
```
@Deprecated
public static SelenideElement $(org.openqa.selenium.WebElement parent,
                                            org.openqa.selenium.By seleniumSelector,
                                            int index)
```
    Deprecated. please use $(parent).$(By, int) which is the same (method will not be removed until 4.x or later)
    
    Parameters:
    
    parent - the WebElement to search elements in
    
    seleniumSelector - any Selenium selector like By.id(), By.name() etc.
    
    index - 0..N
    
    Returns:
    
    SelenideElement
    
    See Also:
    
    Find the Nth element matching given criteria
  - $$
```
public static ElementsCollection $$(java.util.Collection<? extends org.openqa.selenium.WebElement> elements)
```
    Initialize collection with Elements
    
    Parameters:
    
    elements -
    
    Returns:
  - $$
```
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
  - $$
```
@Deprecated
public static ElementsCollection $$(org.openqa.selenium.WebElement parent,
                                                java.lang.String cssSelector)
```
    Deprecated. please use $(parent).$$(String) which is the same (method will not be removed until 4.x or later)
    
    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
    
    See Also:
    
    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.
  - $$
```
@Deprecated
public static ElementsCollection $$(org.openqa.selenium.WebElement parent,
                                                org.openqa.selenium.By seleniumSelector)
```
    Deprecated. please use $(parent).$$(By) which is the same (method will not be removed until 4.x or later)
    
    See Also:
    
    Find all elements matching given criteria inside given parent element, $$(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
  - 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
  - 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 <T> T executeJavaScript(java.lang.String jsCode,
                                      java.lang.Object... arguments)
```
    Executes JavaScript
  - selectRadio
```
public static SelenideElement selectRadio(org.openqa.selenium.By radioField,
                                          java.lang.String value)
```
    Not recommended. It's better to use method $(radioField).selectRadio(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)
```
    Returns selected element in radio group
    
    Parameters:
    
    radioField -
    
    Returns:
    
    null, if nothing selected
  - onConfirmReturn
```
public static void onConfirmReturn(boolean confirmReturnValue)
```
    Mock confirm dialog that return given value
    
    Parameters:
    
    confirmReturnValue - true = OK, false = CANCEL
  - confirm
```
public static java.lang.String confirm()
```
    Accept (Click "Yes" or "Ok") in the confirmation dialog (javascript 'alert' or 'confirm').
    
    Returns:
    
    actual dialog text
  - confirm
```
public static java.lang.String 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)
    
    Returns:
    
    actual dialog text
    
    Throws:
    
    DialogTextMismatch - if confirmation message differs from expected message
  - dismiss
```
public static java.lang.String dismiss()
```
    Dismiss (click "No" or "Cancel") in the confirmation dialog (javascript 'alert' or 'confirm').
    
    Returns:
    
    actual dialog text
  - dismiss
```
public static java.lang.String 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)
    
    Returns:
    
    actual dialog text
    
    Throws:
    
    DialogTextMismatch - if confirmation message differs from expected message
  - switchTo
```
public static SelenideTargetLocator switchTo()
```
    Switch to window/tab/frame/parentFrame/innerFrame/alert. Allows switching to window by title, index, name etc. Similar to org.openqa.selenium.WebDriver#switchTo(), but all methods wait until frame/window/alert appears if it's not visible yet (like other Selenide methods).
    
    Returns:
    
    SelenideTargetLocator
  - getFocusedElement
```
public static org.openqa.selenium.WebElement getFocusedElement()
```
    Returns:
    
    WebElement, not SelenideElement! which has focus on it
  - page
```
public static <PageObjectClass> PageObjectClass page(java.lang.Class<PageObjectClass> pageObjectClass)
```
    Create a Page Object instance.
    
    See Also:
    
    PageFactory.initElements(WebDriver, Class)
  - page
```
public static <PageObjectClass,T extends PageObjectClass> PageObjectClass page(T pageObject)
```
    Create a Page Object instance.
    
    See Also:
    
    PageFactory.initElements(WebDriver, Class)
  - Wait
```
public static org.openqa.selenium.support.ui.FluentWait<org.openqa.selenium.WebDriver> Wait()
```
    Create a org.openqa.selenium.support.ui.FluentWait instance with Selenide timeout/polling. Sample usage: Wait().until(invisibilityOfElementLocated(By.id("magic-id")));
    
    Returns:
    
    instance of org.openqa.selenium.support.ui.FluentWait
  - 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();
 
```
  - getJavascriptErrors
```
public static java.util.List<java.lang.String> getJavascriptErrors()
```
    Get JavaScript errors that happened on this page. Format can differ from browser to browser: - Uncaught ReferenceError: $ is not defined at http://localhost:35070/page_with_js_errors.html:8 - ReferenceError: Can't find variable: $ at http://localhost:8815/page_with_js_errors.html:8 Function returns nothing if the page has its own "window.onerror" handler.
    
    Returns:
    
    list of error messages. Returns empty list if webdriver is not started properly.
  - assertNoJavascriptErrors
```
public static void assertNoJavascriptErrors()
                                     throws JavaScriptErrorsFound
```
    Check if there is not JS errors on the page
    
    Throws:
    
    JavaScriptErrorsFound
  - zoom
```
public static void zoom(double factor)
```
    Zoom current page (in or out).
    
    Parameters:
    
    factor - e.g. 1.1 or 2.0 or 0.5
  - getWebDriverLogs
```
public static java.util.List<java.lang.String> getWebDriverLogs(java.lang.String logType)
```
    Same as com.codeborne.selenide.Selenide#getWebDriverLogs(java.lang.String, java.util.logging.Level)
  - getWebDriverLogs
```
public static java.util.List<java.lang.String> getWebDriverLogs(java.lang.String logType,
                                                                java.util.logging.Level logLevel)
```
    Getting and filtering of the WebDriver logs for specified LogType by specified logging level
    For example to get WebDriver Browser's console output (including JS info, warnings, errors, etc. messages) you can use:
```
   
     for(String logEntry : getWebDriverLogs(LogType.BROWSER, Level.ALL)) {
       Reporter.log(logEntry + "<br />");
     }
   
 
```
    Be aware that currently "manage().logs()" is in the Beta stage, but it is beta-then-nothing :)
    List of the unsupported browsers and issues:
    http://bit.ly/RZcmrM
    http://bit.ly/1nZTaqu
    Parameters:
    
    logType - WebDriver supported log types
    
    logLevel - logging level that will be used to control logging output
    
    Returns:
    
    list of log entries
    
    See Also:
    
    org.openqa.selenium.logging.LogType,, Level

Class Selenide

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

navigator

Constructor Detail

Selenide

Method Detail

open

open

updateHash

open

open

close

refresh

back

forward

title

sleep

screenshot

$

$

$

$

$

$

$

$

$

$$

$$

$$

$$

$$

getElement

getElement

getElements

executeJavaScript

selectRadio

getSelectedRadio

onConfirmReturn

confirm

confirm

dismiss

dismiss

switchTo

getFocusedElement

page

page

Wait

actions

getJavascriptErrors

assertNoJavascriptErrors

zoom

getWebDriverLogs

getWebDriverLogs