SelenideElement (selenide 5.17.2 API)

```
public interface SelenideElement
```
Wrapper around WebElement with additional methods like shouldBe(Condition...) and shouldHave(Condition...)

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`SelenideElement`	`$(By selector)` ATTENTION! This method doesn't start any search yet! Same as `find(String)`
`SelenideElement`	`$(By selector, int index)` ATTENTION! This method doesn't start any search yet! Same as `find(String, int)`
`SelenideElement`	`$(java.lang.String cssSelector)` ATTENTION! This method doesn't start any search yet! Same as `find(String)`
`SelenideElement`	`$(java.lang.String cssSelector, int index)` ATTENTION! This method doesn't start any search yet! Same as `find(String, int)`
`ElementsCollection`	`$$(By selector)` Same as `findAll(By)`
`ElementsCollection`	`$$(java.lang.String cssSelector)` ATTENTION! This method doesn't start any search yet! Same as `findAll(String)`
`ElementsCollection`	`$$x(java.lang.String xpath)` Short form of `webDriver.findElements(thisElement, By.xpath(xpath))`
`SelenideElement`	`$x(java.lang.String xpath)` Locates the first matching element inside given element using xpath locator
`SelenideElement`	`$x(java.lang.String xpath, int index)` Locates the Nth matching element inside given element using xpath locator
`SelenideElement`	`append(java.lang.String text)` Append given text to the text field and trigger "change" event.
`SelenideElement`	`as(java.lang.String alias)` Give this element a human-readable name Caution: you probably don't need this method.
`java.lang.String`	`attr(java.lang.String attributeName)` Get the attribute of the element.
`void`	`click()` Click the element
`void`	`click(ClickOptions clickOption)` Click the element using `ClickOptions`: `$("#username").click(ClickOptions.usingJavaScript())`
`void`	`click(int offsetX, int offsetY)` Deprecated. use `click(ClickOptions)` with offsets
`SelenideElement`	`closest(java.lang.String tagOrClass)` Locates closes ancestor element matching given criteria ATTENTION! This method doesn't start any search yet! For example, $("td").closest("table") could give some "table".
`SelenideElement`	`contextClick()` Click with right mouse button on this element
`java.lang.String`	`data(java.lang.String dataAttributeName)` Get value of attribute "data-dataAttributeName"
`SelenideElement`	`doubleClick()` Double click the element
`java.io.File`	`download()` Download file by clicking this element.
`java.io.File`	`download(DownloadOptions options)`
`java.io.File`	`download(FileFilter fileFilter)` Download file by clicking this element.
`java.io.File`	`download(long timeout)` Download file by clicking this element.
`java.io.File`	`download(long timeout, FileFilter fileFilter)` Download file by clicking this element.
`SelenideElement`	`dragAndDropTo(java.lang.String targetCssSelector)` Drag and drop this element to the target
`SelenideElement`	`dragAndDropTo(WebElement target)` Drag and drop this element to the target
`<ReturnType> ReturnType`	`execute(Command<ReturnType> command)` Execute custom implemented command
`boolean`	`exists()` Checks if element exists true on the current page.
`SelenideElement`	`find(By selector)` ATTENTION! This method doesn't start any search yet! Same as `find(String)`
`SelenideElement`	`find(By selector, int index)` ATTENTION! This method doesn't start any search yet! Same as `find(String, int)`
`SelenideElement`	`find(java.lang.String cssSelector)` Locates the first matching element inside given element
`SelenideElement`	`find(java.lang.String cssSelector, int index)` Locates the Nth matching element inside given element
`ElementsCollection`	`findAll(By selector)` Short form of `webDriver.findElements(thisElement, selector)`
`ElementsCollection`	`findAll(java.lang.String cssSelector)` Short form of `webDriver.findElements(thisElement, By.cssSelector(cssSelector))`
`java.lang.String`	`getAttribute(java.lang.String name)`
`java.lang.String`	`getCssValue(java.lang.String propertyName)`
`java.lang.String`	`getOwnText()` Get the text of the element WITHOUT children.
`java.lang.String`	`getSearchCriteria()` Return criteria by which this element is located
`SelenideElement`	`getSelectedOption()` Find (first) selected option from this select field
`ElementsCollection`	`getSelectedOptions()` Find all selected options from this select field
`java.lang.String`	`getSelectedText()` Get text of selected option in select field
`java.lang.String`	`getSelectedValue()` Get value of selected option in select field
`java.lang.String`	`getText()` Get the visible text of this element, including sub-elements without leading/trailing whitespace.
`java.lang.String`	`getValue()` Get the "value" attribute of the element
`WebElement`	`getWrappedElement()`
`boolean`	`has(Condition condition)` immediately returns true if element matches given condition Method doesn't wait! WARNING: This method can help implementing crooks, but it is not needed for typical ui tests.
`SelenideElement`	`hover()` Emulate "mouseOver" event.
`java.lang.String`	`innerHtml()` Get the HTML code of the element with children.
`java.lang.String`	`innerText()` Get the text code of the element with children.
`boolean`	`is(Condition condition)` immediately returns true if element matches given condition Method doesn't wait! WARNING: This method can help implementing crooks, but it is not needed for typical ui tests.
`boolean`	`isDisplayed()` Check if this element exists and visible.
`boolean`	`isImage()` Check if image is properly loaded.
`SelenideElement`	`lastChild()` Get last child element of this element ATTENTION! this method doesn't start any search yet! For example, $("tr").lastChild(); could give the last "td".
`java.lang.String`	`name()` Get the "name" attribute of the element
`SelenideElement`	`parent()` Get parent element of this element ATTENTION! This method doesn't start any search yet! For example, $("td").parent() could give some "tr".
`SelenideElement`	`preceding(int index)` Get the preceding sibling element of this element ATTENTION! This method doesn't start any search yet! For example, $("td").preceding(0) will give the first preceding sibling element of "td"
`SelenideElement`	`pressEnter()` Press ENTER.
`SelenideElement`	`pressEscape()` Press ESCAPE.
`SelenideElement`	`pressTab()` Press TAB.
`java.lang.String`	`pseudo(java.lang.String pseudoElementName)` Get content of the pseudo-element
`java.lang.String`	`pseudo(java.lang.String pseudoElementName, java.lang.String propertyName)` Get the property value of the pseudo-element
`java.io.File`	`screenshot()` Take screenshot of this element
`java.awt.image.BufferedImage`	`screenshotAsImage()` Take screenshot of this element
`SelenideElement`	`scrollIntoView(boolean alignToTop)` Ask browser to scrolls the element on which it's called into the visible area of the browser window.
`SelenideElement`	`scrollIntoView(java.lang.String scrollIntoViewOptions)` Ask browser to scrolls the element on which it's called into the visible area of the browser window.
`SelenideElement`	`scrollTo()` Ask browser to scroll to this element
`void`	`selectOption(int... index)` Select an option from dropdown list (by index)
`void`	`selectOption(java.lang.String... text)` Select an option from dropdown list (by text)
`void`	`selectOptionByValue(java.lang.String... value)` Select an option from dropdown list (by value)
`void`	`selectOptionContainingText(java.lang.String text)` Select an option from dropdown list that contains given text
`SelenideElement`	`selectRadio(java.lang.String value)` Select radio button
`SelenideElement`	`setSelected(boolean selected)` Set checkbox state to CHECKED or UNCHECKED.
`SelenideElement`	`setValue(java.lang.String text)` Implementation details:
`SelenideElement`	`should(Condition... condition)` Checks that given element meets all of given conditions.
`SelenideElement`	`should(Condition condition, java.time.Duration timeout)` Wait until given element meets given condition (with given timeout)
`SelenideElement`	`shouldBe(Condition... condition)` Synonym for `should(com.codeborne.selenide.Condition...)`.
`SelenideElement`	`shouldBe(Condition condition, java.time.Duration timeout)` Wait until given element meets given condition (with given timeout)
`SelenideElement`	`shouldHave(Condition... condition)` Synonym for `should(com.codeborne.selenide.Condition...)`.
`SelenideElement`	`shouldHave(Condition condition, java.time.Duration timeout)` Wait until given element meets given condition (with given timeout)
`SelenideElement`	`shouldNot(Condition... condition)` Checks that given element does not meet given conditions.
`SelenideElement`	`shouldNot(Condition condition, java.time.Duration timeout)` Wait until given element meets given condition (with given timeout)
`SelenideElement`	`shouldNotBe(Condition... condition)` Synonym for `shouldNot(com.codeborne.selenide.Condition...)`.
`SelenideElement`	`shouldNotBe(Condition condition, java.time.Duration timeout)` Wait until given element does NOT meet given condition (with given timeout)
`SelenideElement`	`shouldNotHave(Condition... condition)` Synonym for `shouldNot(com.codeborne.selenide.Condition...)`.
`SelenideElement`	`shouldNotHave(Condition condition, java.time.Duration timeout)` Wait until given element does NOT meet given condition (with given timeout)
`SelenideElement`	`sibling(int index)` Get the following sibling element of this element ATTENTION! This method doesn't start any search yet! For example, $("td").sibling(0) will give the first following sibling element of "td"
`java.lang.String`	`text()` Short form of `getText()`
`java.lang.String`	`toString()` Displays WebElement in human-readable format.
`WebElement`	`toWebElement()`
`java.io.File`	`uploadFile(java.io.File... file)` Upload file into file upload field.
`java.io.File`	`uploadFromClasspath(java.lang.String... fileName)` Upload file into file upload field.
`java.lang.String`	`val()` Get the "value" attribute of the element Same as `getValue()`
`SelenideElement`	`val(java.lang.String text)` Same as `setValue(java.lang.String)`
`SelenideElement`	`waitUntil(Condition condition, long timeoutMilliseconds)` Deprecated. use `shouldBe(Condition, Duration)` or @deprecated use `shouldHave(Condition, Duration)`
`SelenideElement`	`waitUntil(Condition condition, long timeoutMilliseconds, long pollingIntervalMilliseconds)` Deprecated. use `shouldBe(Condition, Duration)` or @deprecated use `shouldHave(Condition, Duration)`
`SelenideElement`	`waitWhile(Condition condition, long timeoutMilliseconds)` Deprecated. use `shouldBe(Condition, Duration)` or @deprecated use `shouldHave(Condition, Duration)`
`SelenideElement`	`waitWhile(Condition condition, long timeoutMilliseconds, long pollingIntervalMilliseconds)` Deprecated. use `shouldBe(Condition, Duration)` or @deprecated use `shouldHave(Condition, Duration)`

- Method Detail
  - setValue
```
SelenideElement setValue(java.lang.String text)
```
    Implementation details:
    If Configuration.versatileSetValue is true, can work as 'selectOptionByValue', 'selectRadio'
    
    If Configuration.fastSetValue is true, sets value by javascript instead of using Selenium built-in "sendKey" function and trigger "focus", "keydown", "keypress", "input", "keyup", "change" events.
    In other case behavior will be:
```
 1. WebElement.clear()
 2. WebElement.sendKeys(text)
 3. Trigger change event
 
```
    Parameters:
    
    text - Any text to enter into the text field or set by value for select/radio.
    
    See Also:
    
    SetValue
  - val
```
SelenideElement val(java.lang.String text)
```
    Same as setValue(java.lang.String)
    
    See Also:
    
    Val
  - append
```
SelenideElement append(java.lang.String text)
```
    Append given text to the text field and trigger "change" event.
    Implementation details: This is the same as
```
   1. WebElement.sendKeys(text)
   2. Trigger change event
 
```
    Parameters:
    
    text - Any text to append into the text field.
    
    See Also:
    
    Append
  - pressEnter
```
SelenideElement pressEnter()
```
    Press ENTER. Useful for input field and textareas:
```
  $("query").val("Aikido techniques").pressEnter();
```
    Implementation details: Check that element is displayed and execute
```
  WebElement.sendKeys(Keys.ENTER)
```
    See Also:
    
    PressEnter
  - pressTab
```
SelenideElement pressTab()
```
    Press TAB. Useful for input field and textareas:
```
  $("#to").val("stiven@seagal.com").pressTab();
```
    Implementation details: Check that element is displayed and execute
```
  WebElement.sendKeys(Keys.TAB)
```
    See Also:
    
    PressTab
  - pressEscape
```
SelenideElement pressEscape()
```
    Press ESCAPE. Useful for input field and textareas:
```
  $(".edit").click().pressEscape();
```
    Implementation details: Check that element is displayed and execute
```
  WebElement.sendKeys(Keys.ESCAPE)
```
    See Also:
    
    PressEscape
  - getText
```
java.lang.String getText()
```
    Get the visible text of this element, including sub-elements without leading/trailing whitespace. NB! For "select", returns text(s) of selected option(s).
    
    Returns:
    
    The innerText of this element
    
    See Also:
    
    GetText
  - text
```
java.lang.String text()
```
    Short form of getText()
    
    See Also:
    
    WebElement#getText(), GetText
  - getOwnText
```
java.lang.String getOwnText()
```
    Get the text of the element WITHOUT children.
    
    See Also:
    
    GetOwnText
  - innerText
```
java.lang.String innerText()
```
    Get the text code of the element with children.
    It can be used to get the text of a hidden element.
    Short form of getAttribute("textContent") or getAttribute("innerText") depending on browser.
    
    See Also:
    
    GetInnerText
  - innerHtml
```
java.lang.String innerHtml()
```
    Get the HTML code of the element with children.
    It can be used to get the html of a hidden element.
    Short form of getAttribute("innerHTML")
    
    See Also:
    
    GetInnerHtml
  - attr
```
java.lang.String attr(java.lang.String attributeName)
```
    Get the attribute of the element. Synonym for getAttribute(String)
    
    Returns:
    
    null if attribute is missing
    
    See Also:
    
    GetAttribute
  - name
```
java.lang.String name()
```
    Get the "name" attribute of the element
    
    Returns:
    
    attribute "name" value or null if attribute is missing
    
    See Also:
    
    GetName
  - val
```
java.lang.String val()
```
    Get the "value" attribute of the element Same as getValue()
    
    Returns:
    
    attribute "value" value or null if attribute is missing
    
    See Also:
    
    Val
  - getValue
```
java.lang.String getValue()
```
    Get the "value" attribute of the element
    
    Returns:
    
    attribute "value" value or null if attribute is missing
    
    Since:
    
    3.1
    
    See Also:
    
    GetValue
  - pseudo
```
java.lang.String pseudo(java.lang.String pseudoElementName,
                        java.lang.String propertyName)
```
    Get the property value of the pseudo-element
    
    Parameters:
    
    pseudoElementName - pseudo-element name of the element, ":before", ":after", ":first-letter", ":first-line", ":selection"
    
    propertyName - property name of the pseudo-element
    
    Returns:
    
    the property value or "" if the property is missing
    
    See Also:
    
    GetPseudoValue
  - pseudo
```
java.lang.String pseudo(java.lang.String pseudoElementName)
```
    Get content of the pseudo-element
    
    Parameters:
    
    pseudoElementName - pseudo-element name of the element, ":before", ":after"
    
    Returns:
    
    the content value or "none" if the content is missing
    
    See Also:
    
    GetPseudoValue
  - selectRadio
```
SelenideElement selectRadio(java.lang.String value)
```
    Select radio button
    
    Parameters:
    
    value - value of radio button to select
    
    Returns:
    
    selected "input type=radio" element
    
    See Also:
    
    SelectRadio
  - data
```
java.lang.String data(java.lang.String dataAttributeName)
```
    Get value of attribute "data-dataAttributeName"
    
    See Also:
    
    GetDataAttribute
  - getAttribute
```
java.lang.String getAttribute(java.lang.String name)
```
  - getCssValue
```
java.lang.String getCssValue(java.lang.String propertyName)
```
  - exists
```
boolean exists()
```
    Checks if element exists true on the current page.
    
    Returns:
    
    false if element is not found, browser is closed or any WebDriver exception happened
    
    See Also:
    
    Exists
  - isDisplayed
```
boolean isDisplayed()
```
    Check if this element exists and visible.
    
    Returns:
    
    false if element does not exists, is invisible, browser is closed or any WebDriver exception happened.
  - is
```
boolean is(Condition condition)
```
    immediately returns true if element matches given condition Method doesn't wait! WARNING: This method can help implementing crooks, but it is not needed for typical ui tests.
    
    See Also:
    
    has(com.codeborne.selenide.Condition), Matches
  - has
```
boolean has(Condition condition)
```
    immediately returns true if element matches given condition Method doesn't wait! WARNING: This method can help implementing crooks, but it is not needed for typical ui tests.
    
    See Also:
    
    is(com.codeborne.selenide.Condition), Matches
  - setSelected
```
SelenideElement setSelected(boolean selected)
```
    Set checkbox state to CHECKED or UNCHECKED.
    
    Parameters:
    
    selected - true for checked and false for unchecked
    
    See Also:
    
    SetSelected
  - should
```
SelenideElement should(Condition... condition)
```
    Checks that given element meets all of given conditions.
    
    IMPORTANT: If element does not match then conditions immediately, waits up to 4 seconds until element meets the conditions. It's extremely useful for dynamic content.
    
    Timeout is configurable via Configuration.timeout
    
    For example: $("#errorMessage").should(appear);
    
    Returns:
    
    Given element, useful for chaining: $("#errorMessage").should(appear).shouldBe(enabled);
    
    See Also:
    
    Config.timeout(), Should
  - should
```
SelenideElement should(Condition condition,
                       java.time.Duration timeout)
```
    Wait until given element meets given condition (with given timeout)
  - shouldHave
```
SelenideElement shouldHave(Condition... condition)
```
    Synonym for should(com.codeborne.selenide.Condition...). Useful for better readability.
    
    For example: $("#errorMessage").shouldHave(text("Hello"), text("World"));
    
    See Also:
    
    should(com.codeborne.selenide.Condition...), ShouldHave
  - shouldHave
```
SelenideElement shouldHave(Condition condition,
                           java.time.Duration timeout)
```
    Wait until given element meets given condition (with given timeout)
  - shouldBe
```
SelenideElement shouldBe(Condition... condition)
```
    Synonym for should(com.codeborne.selenide.Condition...). Useful for better readability.
    
    For example: $("#errorMessage").shouldBe(visible, enabled);
    
    See Also:
    
    should(com.codeborne.selenide.Condition...), ShouldBe
  - shouldBe
```
SelenideElement shouldBe(Condition condition,
                         java.time.Duration timeout)
```
    Wait until given element meets given condition (with given timeout)
  - shouldNot
```
SelenideElement shouldNot(Condition... condition)
```
    Checks that given element does not meet given conditions.
    
    IMPORTANT: If element does match the conditions, waits up to 4 seconds until element does not meet the conditions. It's extremely useful for dynamic content.
    
    Timeout is configurable via Configuration.timeout
    
    For example: $("#errorMessage").should(exist);
    
    See Also:
    
    Config.timeout(), ShouldNot
  - shouldNot
```
SelenideElement shouldNot(Condition condition,
                          java.time.Duration timeout)
```
    Wait until given element meets given condition (with given timeout)
  - shouldNotHave
```
SelenideElement shouldNotHave(Condition... condition)
```
    Synonym for shouldNot(com.codeborne.selenide.Condition...). Useful for better readability.
    
    For example: $("#errorMessage").shouldNotHave(text("Exception"), text("Error"));
    
    See Also:
    
    shouldNot(com.codeborne.selenide.Condition...), ShouldNotHave
  - shouldNotHave
```
SelenideElement shouldNotHave(Condition condition,
                              java.time.Duration timeout)
```
    Wait until given element does NOT meet given condition (with given timeout)
  - shouldNotBe
```
SelenideElement shouldNotBe(Condition... condition)
```
    Synonym for shouldNot(com.codeborne.selenide.Condition...). Useful for better readability.
    
    For example: $("#errorMessage").shouldNotBe(visible, enabled);
    
    See Also:
    
    shouldNot(com.codeborne.selenide.Condition...), ShouldNotBe
  - shouldNotBe
```
SelenideElement shouldNotBe(Condition condition,
                            java.time.Duration timeout)
```
    Wait until given element does NOT meet given condition (with given timeout)
  - waitUntil
```
@Deprecated
SelenideElement waitUntil(Condition condition,
                                      long timeoutMilliseconds)
```
    Deprecated. use shouldBe(Condition, Duration) or @deprecated use shouldHave(Condition, Duration)
    
    Wait until given element meets given conditions.
    
    IMPORTANT: in most cases you don't need this method because all should- methods wait too. You need to use #waitUntil or #waitWhile methods only if you need another timeout.
    
    Parameters:
    
    condition - e.g. enabled, visible, text() and so on
    
    timeoutMilliseconds - timeout in milliseconds.
    
    See Also:
    
    WaitUntil
  - waitUntil
```
@Deprecated
SelenideElement waitUntil(Condition condition,
                                      long timeoutMilliseconds,
                                      long pollingIntervalMilliseconds)
```
    Deprecated. use shouldBe(Condition, Duration) or @deprecated use shouldHave(Condition, Duration)
    
    Wait until given element meets given conditions.
    
    IMPORTANT: in most cases you don't need this method because all should- methods wait too. You need to use #waitUntil or #waitWhile methods only if you need another timeout.
    
    Parameters:
    
    condition - e.g. enabled, visible, text() and so on
    
    timeoutMilliseconds - timeout in milliseconds.
    
    pollingIntervalMilliseconds - interval in milliseconds, when checking condition
    
    See Also:
    
    WaitUntil
  - waitWhile
```
@Deprecated
SelenideElement waitWhile(Condition condition,
                                      long timeoutMilliseconds)
```
    Deprecated. use shouldBe(Condition, Duration) or @deprecated use shouldHave(Condition, Duration)
    
    Wait until given element does not meet given conditions.
    
    IMPORTANT: in most cases you don't need this method because all shouldNot- methods wait too. You need to use #waitUntil or #waitWhile methods only if you need another timeout.
    
    Parameters:
    
    condition - e.g. enabled, visible, text() and so on
    
    timeoutMilliseconds - timeout in milliseconds.
    
    See Also:
    
    WaitWhile
  - waitWhile
```
@Deprecated
SelenideElement waitWhile(Condition condition,
                                      long timeoutMilliseconds,
                                      long pollingIntervalMilliseconds)
```
    Deprecated. use shouldBe(Condition, Duration) or @deprecated use shouldHave(Condition, Duration)
    
    Wait until given element does not meet given conditions.
    
    IMPORTANT: in most cases you don't need this method because all shouldNot- methods wait too. You need to use #waitUntil or #waitWhile methods only if you need another timeout.
    
    Parameters:
    
    condition - e.g. enabled, visible, text() and so on
    
    timeoutMilliseconds - timeout in milliseconds.
    
    pollingIntervalMilliseconds - interval in milliseconds, when checking condition
    
    See Also:
    
    WaitWhile
  - toString
```
java.lang.String toString()
```
    Displays WebElement in human-readable format. Useful for logging and debugging. Not recommended to use for test verifications.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    e.g. Order has been confirmed
    
    See Also:
    
    ToString
  - as
```
SelenideElement as(java.lang.String alias)
```
    Give this element a human-readable name Caution: you probably don't need this method. It's always a good idea to have the actual selector instead of "nice" description (which might be misleading or even lying).
    
    Parameters:
    
    alias - a human-readable name of this element (null or empty string not allowed)
    
    Returns:
    
    this element
    
    Since:
    
    5.17.0
  - parent
```
SelenideElement parent()
```
    Get parent element of this element ATTENTION! This method doesn't start any search yet! For example, $("td").parent() could give some "tr".
    
    Returns:
    
    Parent element
    
    See Also:
    
    GetParent
  - sibling
```
SelenideElement sibling(int index)
```
    Get the following sibling element of this element ATTENTION! This method doesn't start any search yet! For example, $("td").sibling(0) will give the first following sibling element of "td"
    
    Parameters:
    
    index - the index of sibling element
    
    Returns:
    
    Sibling element by index
    
    See Also:
    
    GetSibling
  - preceding
```
SelenideElement preceding(int index)
```
    Get the preceding sibling element of this element ATTENTION! This method doesn't start any search yet! For example, $("td").preceding(0) will give the first preceding sibling element of "td"
    
    Parameters:
    
    index - the index of sibling element
    
    Returns:
    
    Sibling element by index
    
    See Also:
    
    GetPreceding
  - lastChild
```
SelenideElement lastChild()
```
    Get last child element of this element ATTENTION! this method doesn't start any search yet! For example, $("tr").lastChild(); could give the last "td".
  - closest
```
SelenideElement closest(java.lang.String tagOrClass)
```
    Locates closes ancestor element matching given criteria ATTENTION! This method doesn't start any search yet! For example, $("td").closest("table") could give some "table".
    
    Parameters:
    
    tagOrClass - Either HTML tag or CSS class. E.g. "form" or ".active".
    
    Returns:
    
    Matching ancestor element
    
    See Also:
    
    GetClosest
  - find
```
SelenideElement find(java.lang.String cssSelector)
```
    Locates the first matching element inside given element
    ATTENTION! This method doesn't start any search yet!
    Short form of webElement.findElement(By.cssSelector(cssSelector))
    
    See Also:
    
    Find
  - find
```
SelenideElement find(java.lang.String cssSelector,
                     int index)
```
    Locates the Nth matching element inside given element
    ATTENTION! This method doesn't start any search yet!
    
    See Also:
    
    Find
  - find
```
SelenideElement find(By selector)
```
    ATTENTION! This method doesn't start any search yet! Same as find(String)
    
    See Also:
    
    Find
  - find
```
SelenideElement find(By selector,
                     int index)
```
    ATTENTION! This method doesn't start any search yet! Same as find(String, int)
    
    See Also:
    
    Find
  - $
```
SelenideElement $(java.lang.String cssSelector)
```
    ATTENTION! This method doesn't start any search yet! Same as find(String)
    
    See Also:
    
    Find
  - $
```
SelenideElement $(java.lang.String cssSelector,
                  int index)
```
    ATTENTION! This method doesn't start any search yet! Same as find(String, int)
    
    See Also:
    
    Find
  - $
```
SelenideElement $(By selector)
```
    ATTENTION! This method doesn't start any search yet! Same as find(String)
    
    See Also:
    
    Find
  - $
```
SelenideElement $(By selector,
                  int index)
```
    ATTENTION! This method doesn't start any search yet! Same as find(String, int)
    
    See Also:
    
    Find
  - $x
```
SelenideElement $x(java.lang.String xpath)
```
    Locates the first matching element inside given element using xpath locator
    ATTENTION! This method doesn't start any search yet!
    Short form of webElement.findElement(By.xpath(xpathLocator))
    
    See Also:
    
    FindByXpath
  - $x
```
SelenideElement $x(java.lang.String xpath,
                   int index)
```
    Locates the Nth matching element inside given element using xpath locator
    ATTENTION! This method doesn't start any search yet!
    
    See Also:
    
    FindByXpath
  - findAll
```
ElementsCollection findAll(java.lang.String cssSelector)
```
    Short form of webDriver.findElements(thisElement, By.cssSelector(cssSelector))
    ATTENTION! This method doesn't start any search yet!
    For example, $("#multirowTable").findAll("tr.active").shouldHave(size(2));
    
    Returns:
    
    list of elements inside given element matching given CSS selector
    
    See Also:
    
    FindAll
  - findAll
```
ElementsCollection findAll(By selector)
```
    Short form of webDriver.findElements(thisElement, selector)
    ATTENTION! This method doesn't start any search yet!
    For example, $("#multirowTable").findAll(By.className("active")).shouldHave(size(2));
    
    Returns:
    
    list of elements inside given element matching given criteria
    
    See Also:
    
    FindAll
  - $$
```
ElementsCollection $$(java.lang.String cssSelector)
```
    ATTENTION! This method doesn't start any search yet! Same as findAll(String)
  - $$
```
ElementsCollection $$(By selector)
```
    Same as findAll(By)
  - $$x
```
ElementsCollection $$x(java.lang.String xpath)
```
    Short form of webDriver.findElements(thisElement, By.xpath(xpath))
    ATTENTION! This method doesn't start any search yet!
    For example, $("#multirowTable").$$x("./input").shouldHave(size(2));
    
    Returns:
    
    list of elements inside given element matching given xpath locator
    
    See Also:
    
    FindAllByXpath
  - uploadFromClasspath
```
java.io.File uploadFromClasspath(java.lang.String... fileName)
```
    Upload file into file upload field. File is searched from classpath.
    
    Multiple file upload is also supported. Just pass as many file names as you wish.
    
    Parameters:
    
    fileName - name of the file or the relative path in classpath e.g. "files/1.pfd"
    
    Returns:
    
    the object of the first file uploaded
    
    Throws:
    
    java.lang.IllegalArgumentException - if any of the files is not found
    
    See Also:
    
    UploadFileFromClasspath
  - uploadFile
```
java.io.File uploadFile(java.io.File... file)
```
    Upload file into file upload field.
    
    Multiple file upload is also supported. Just pass as many files as you wish.
    
    Parameters:
    
    file - file object(s)
    
    Returns:
    
    the object of the first file uploaded
    
    Throws:
    
    java.lang.IllegalArgumentException - if any of the files is not found, or other errors
    
    See Also:
    
    UploadFile
  - selectOption
```
void selectOption(int... index)
```
    Select an option from dropdown list (by index)
    
    Parameters:
    
    index - 0..N (0 means first option)
    
    See Also:
    
    SelectOptionByTextOrIndex
  - selectOption
```
void selectOption(java.lang.String... text)
```
    Select an option from dropdown list (by text)
    
    Parameters:
    
    text - visible text of option
    
    See Also:
    
    SelectOptionByTextOrIndex
  - selectOptionContainingText
```
void selectOptionContainingText(java.lang.String text)
```
    Select an option from dropdown list that contains given text
    
    Parameters:
    
    text - substring of visible text of option
    
    See Also:
    
    SelectOptionContainingText
  - selectOptionByValue
```
void selectOptionByValue(java.lang.String... value)
```
    Select an option from dropdown list (by value)
    
    Parameters:
    
    value - "value" attribute of option
    
    See Also:
    
    SelectOptionByValue
  - getSelectedOption
```
SelenideElement getSelectedOption()
                           throws NoSuchElementException
```
    Find (first) selected option from this select field
    
    Returns:
    
    WebElement for selected <option> element
    
    Throws:
    
    NoSuchElementException - if no options are selected
    
    See Also:
    
    GetSelectedOption
  - getSelectedOptions
```
ElementsCollection getSelectedOptions()
```
    Find all selected options from this select field
    
    Returns:
    
    ElementsCollection for selected <option> elements (empty list if no options are selected)
    
    See Also:
    
    GetSelectedOptions
  - getSelectedValue
```
java.lang.String getSelectedValue()
```
    Get value of selected option in select field
    
    Returns:
    
    null if the selected option doesn't have "value" attribute
    
    See Also:
    
    GetSelectedValue
  - getSelectedText
```
java.lang.String getSelectedText()
```
    Get text of selected option in select field
    
    See Also:
    
    GetSelectedText
  - scrollTo
```
SelenideElement scrollTo()
```
    Ask browser to scroll to this element
    
    See Also:
    
    ScrollTo
  - scrollIntoView
```
SelenideElement scrollIntoView(boolean alignToTop)
```
    Ask browser to scrolls the element on which it's called into the visible area of the browser window.
    If alignToTop boolean value is true - the top of the element will be aligned to the top.
    If alignToTop boolean value is false - the bottom of the element will be aligned to the bottom. Usage:
```
     element.scrollIntoView(true);
     // Corresponds to scrollIntoViewOptions: {block: "start", inline: "nearest"}

     element.scrollIntoView(false);
     // Corresponds to scrollIntoViewOptions: {block: "end", inline: "nearest"}
 
```
    Parameters:
    
    alignToTop - boolean value that indicate how element will be aligned to the visible area of the scrollable ancestor.
    
    See Also:
    
    ScrollIntoView, Web API reference
  - scrollIntoView
```
SelenideElement scrollIntoView(java.lang.String scrollIntoViewOptions)
```
    Ask browser to scrolls the element on which it's called into the visible area of the browser window.
```
 scrollIntoViewOptions:
  * behavior (optional) - Defines the transition animation
    1. auto (default)
    2. instant
    3. smooth
  * block (optional)
    1. start
    2. center (default)
    3. end
    4. nearest
  * inline
    1. start
    2. center
    3. end
    4. nearest (default)
 
```
    Usage:
```
     element.scrollIntoView("{block: \"end\"}");
     element.scrollIntoView("{behavior: \"instant\", block: \"end\", inline: \"nearest\"}");
 
```
    Parameters:
    
    scrollIntoViewOptions - is an object with the align properties: behavior, block and inline.
    
    See Also:
    
    ScrollIntoView, Web API reference
  - download
```
java.io.File download()
               throws java.io.FileNotFoundException
```
    Download file by clicking this element. Algorithm depends on @{@link Config#fileDownload() }.
    
    Throws:
    
    java.lang.RuntimeException - if 50x status code was returned from server
    
    java.io.FileNotFoundException - if 40x status code was returned from server
    
    See Also:
    
    FileDownloadMode, DownloadFile
  - download
```
java.io.File download(long timeout)
               throws java.io.FileNotFoundException
```
    Download file by clicking this element. Algorithm depends on @{@link Config#fileDownload() }.
    
    Parameters:
    
    timeout - download operations timeout.
    
    Throws:
    
    java.lang.RuntimeException - if 50x status code was returned from server
    
    java.io.FileNotFoundException - if 40x status code was returned from server
    
    See Also:
    
    DownloadFile
  - download
```
java.io.File download(FileFilter fileFilter)
               throws java.io.FileNotFoundException
```
    Download file by clicking this element. Algorithm depends on @{@link Config#fileDownload() }.
    
    Parameters:
    
    fileFilter - Criteria for defining which file is expected ( FileFilters.withName(String), FileFilters.withNameMatching(String), FileFilters.withName(String) ).
    
    Throws:
    
    java.lang.RuntimeException - if 50x status code was returned from server
    
    java.io.FileNotFoundException - if 40x status code was returned from server, or the downloaded file didn't match given filter.
    
    See Also:
    
    FileFilters, DownloadFile
  - download
```
java.io.File download(long timeout,
                      FileFilter fileFilter)
               throws java.io.FileNotFoundException
```
    Download file by clicking this element. Algorithm depends on @{@link Config#fileDownload() }.
    
    Parameters:
    
    timeout - download operations timeout.
    
    fileFilter - Criteria for defining which file is expected ( FileFilters.withName(String), FileFilters.withNameMatching(String), FileFilters.withName(String) ).
    
    Throws:
    
    java.lang.RuntimeException - if 50x status code was returned from server
    
    java.io.FileNotFoundException - if 40x status code was returned from server, or the downloaded file didn't match given filter.
    
    See Also:
    
    FileFilters, DownloadFile
  - download
```
java.io.File download(DownloadOptions options)
               throws java.io.FileNotFoundException
```
    Throws:
    
    java.io.FileNotFoundException
  - getSearchCriteria
```
java.lang.String getSearchCriteria()
```
    Return criteria by which this element is located
    
    Returns:
    
    e.g. "#multirowTable.findBy(text 'INVALID-TEXT')/valid-selector"
  - toWebElement
```
WebElement toWebElement()
```
    Returns:
    
    the original Selenium WebElement wrapped by this object
    
    Throws:
    
    org.openqa.selenium.NoSuchElementException - if element does not exist (without waiting for the element)
    
    See Also:
    
    ToWebElement
  - getWrappedElement
```
WebElement getWrappedElement()
```
    Returns:
    
    Underlying WebElement
    
    Throws:
    
    ElementNotFound - if element does not exist (after waiting for N seconds)
    
    See Also:
    
    GetWrappedElement
  - click
```
void click(ClickOptions clickOption)
```
    Click the element using ClickOptions: $("#username").click(ClickOptions.usingJavaScript())
    You can specify a relative offset from the center of the element inside ClickOptions: e.g. $("#username").click(usingJavaScript().offset(123, 222))
    
    See Also:
    
    Click
  - click
```
void click()
```
    Click the element
    By default it uses default Selenium method click.
    
    But it uses JavaScript method to click if com.codeborne.selenide.Configuration#clickViaJs is defined. It may be helpful for testing in Internet Explorer where native click doesn't always work correctly.
    
    See Also:
    
    Click
  - click
```
@Deprecated
void click(int offsetX,
                       int offsetY)
```
    Deprecated. use click(ClickOptions) with offsets
    
    Click the element with a relative offset from the center of the element
  - contextClick
```
SelenideElement contextClick()
```
    Click with right mouse button on this element
    
    Returns:
    
    this element
    
    See Also:
    
    ContextClick
  - doubleClick
```
SelenideElement doubleClick()
```
    Double click the element
    
    Returns:
    
    this element
    
    See Also:
    
    DoubleClick
  - hover
```
SelenideElement hover()
```
    Emulate "mouseOver" event. In other words, move mouse cursor over this element (without clicking it).
    
    Returns:
    
    this element
    
    See Also:
    
    Hover
  - dragAndDropTo
```
SelenideElement dragAndDropTo(java.lang.String targetCssSelector)
```
    Drag and drop this element to the target
    Before dropping, waits until target element gets visible.
    
    Parameters:
    
    targetCssSelector - CSS selector defining target element
    
    Returns:
    
    this element
    
    See Also:
    
    DragAndDropTo
  - dragAndDropTo
```
SelenideElement dragAndDropTo(WebElement target)
```
    Drag and drop this element to the target
    Before dropping, waits until target element gets visible.
    
    Parameters:
    
    target - target element
    
    Returns:
    
    this element
    
    See Also:
    
    DragAndDropTo
  - execute
```
<ReturnType> ReturnType execute(Command<ReturnType> command)
```
    Execute custom implemented command
    
    Parameters:
    
    command - custom command
    
    Returns:
    
    whatever the command returns (incl. null)
    
    See Also:
    
    Execute, Command
  - isImage
```
boolean isImage()
```
    Check if image is properly loaded.
    
    Throws:
    
    java.lang.IllegalArgumentException - if argument is not an "img" element
    
    Since:
    
    2.13
    
    See Also:
    
    IsImage
  - screenshot
```
java.io.File screenshot()
```
    Take screenshot of this element
    
    Returns:
    
    file with screenshot (*.png) or null if Selenide failed to take a screenshot (due to some technical problem)
    
    See Also:
    
    TakeScreenshot
  - screenshotAsImage
```
java.awt.image.BufferedImage screenshotAsImage()
```
    Take screenshot of this element
    
    Returns:
    
    buffered image with screenshot
    
    See Also:
    
    TakeScreenshotAsImage

Interface SelenideElement

Method Summary

Method Detail

setValue

val

append

pressEnter

pressTab

pressEscape

getText

text

getOwnText

innerText

innerHtml

attr

name

val

getValue

pseudo

pseudo

selectRadio

data

getAttribute

getCssValue

exists

isDisplayed

is

has

setSelected

should

should

shouldHave

shouldHave

shouldBe

shouldBe

shouldNot

shouldNot

shouldNotHave

shouldNotHave

shouldNotBe

shouldNotBe

waitUntil

waitUntil

waitWhile

waitWhile

toString

as

parent

sibling

preceding

lastChild

closest

find

find

find

find

$

$

$

$

$x

$x

findAll

findAll

$$

$$

$$x

uploadFromClasspath

uploadFile

selectOption

selectOption

selectOptionContainingText

selectOptionByValue

getSelectedOption

getSelectedOptions

getSelectedValue

getSelectedText

scrollTo

scrollIntoView

scrollIntoView