com.codeborne.selenide.SelenideElement Maven / Gradle / Ivy

Go to download
package com.codeborne.selenide;

import com.codeborne.selenide.commands.GetSelectedOptionText;
import com.codeborne.selenide.commands.GetSelectedOptionValue;
import com.codeborne.selenide.files.FileFilter;
import com.codeborne.selenide.impl.WebElementSource;
import com.google.errorprone.annotations.CanIgnoreReturnValue;
import org.openqa.selenium.By;
import org.openqa.selenium.NoSuchElementException;
import org.openqa.selenium.TakesScreenshot;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.WrapsDriver;
import org.openqa.selenium.WrapsElement;
import org.openqa.selenium.interactions.Locatable;

import javax.annotation.CheckReturnValue;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.ParametersAreNonnullByDefault;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.FileNotFoundException;
import java.time.Duration;

/**
 * Wrapper around {@link WebElement} with additional methods like
 * {@link #shouldBe(Condition...)} and {@link #shouldHave(Condition...)}
 */
@ParametersAreNonnullByDefault
public interface SelenideElement extends WebElement, WrapsDriver, WrapsElement, Locatable, TakesScreenshot {
  /**
   * Implementation details:
   *
   * 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
   * 
   *
   * @param text Any text to enter into the text field or set by value for select/radio.
   * @see com.codeborne.selenide.commands.SetValue
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement setValue(@Nullable String text);

  /**
   * Same as {@link #setValue(java.lang.String)}
   *
   * @see com.codeborne.selenide.commands.Val
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement val(@Nullable String text);

  /**
   * @see com.codeborne.selenide.commands.SetValue
   * @since 6.5.0
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement setValue(SetValueOptions 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
   * 
   *
   * @param text Any text to append into the text field.
   * @see com.codeborne.selenide.commands.Append
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement append(String text);

  /**
   * Clear the input field
   *
   * Basically it's the same as {@link WebElement#clear()}, but it works. :) 
   * @see com.codeborne.selenide.commands.Clear
   */
  @CanIgnoreReturnValue
  @Override
  void clear();

  /**
   * 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 com.codeborne.selenide.commands.PressEnter
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement pressEnter();

  /**
   * Press TAB. Useful for input field and textareas:    *  $("#to").val("[email protected]").pressTab();
   * 
   * Implementation details:
   * Check that element is displayed and execute 
   *  WebElement.sendKeys(Keys.TAB)
   *
   * @see com.codeborne.selenide.commands.PressTab
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement pressTab();

  /**
   * 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 com.codeborne.selenide.commands.PressEscape
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement pressEscape();

  /**
   * Get the visible text of this element, including sub-elements without leading/trailing whitespace.
   * NB! For "select", returns text(s) of selected option(s).
   *
   * @return The innerText of this element
   * @see com.codeborne.selenide.commands.GetText
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nonnull
  @Override
  String getText();

  /**
   * Element alias, which can be set with {@link #as(String text)}
   *
   * @return Alias of this element or null, if element alias is not set
   * @see com.codeborne.selenide.commands.GetAlias
   * @since 5.20.0
   */
  @CheckReturnValue
  @Nullable
  String getAlias();

  /**
   * Short form of {@link #getText()}
   *
   * @see WebElement#getText()
   * @see com.codeborne.selenide.commands.GetText
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nonnull
  String text();

  /**
   * Get the text of the element WITHOUT children.
   *
   * @see com.codeborne.selenide.commands.GetOwnText
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nonnull
  String getOwnText();

  /**
   * 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 com.codeborne.selenide.commands.GetInnerText
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nonnull
  String innerText();

  /**
   * 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 com.codeborne.selenide.commands.GetInnerHtml
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nonnull
  String innerHtml();

  /**
   * Get the attribute of the element. Synonym for {@link #getAttribute(String)}
   *
   * @return null if attribute is missing
   * @see com.codeborne.selenide.commands.GetAttribute
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nullable
  String attr(String attributeName);

  /**
   * Get the "name" attribute of the element
   *
   * @return attribute "name" value or null if attribute is missing
   * @see com.codeborne.selenide.commands.GetName
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nullable
  String name();

  /**
   * Get the "value" attribute of the element
   * Same as {@link #getValue()}
   *
   * @return attribute "value" value or null if attribute is missing
   * @see com.codeborne.selenide.commands.Val
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nullable
  String val();

  /**
   * Get the "value" attribute of the element
   *
   * @return attribute "value" value or null if attribute is missing
   * @see com.codeborne.selenide.commands.GetValue
   * @since 3.1
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nullable
  String getValue();

  /**
   * Get the property value of the pseudo-element
   *
   * @param pseudoElementName pseudo-element name of the element,
   *                          ":before", ":after", ":first-letter", ":first-line", ":selection"
   * @param propertyName      property name of the pseudo-element
   * @return the property value or "" if the property is missing
   * @see com.codeborne.selenide.commands.GetPseudoValue
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nonnull
  String pseudo(String pseudoElementName, String propertyName);

  /**
   * Get content of the pseudo-element
   *
   * @param pseudoElementName pseudo-element name of the element, ":before", ":after"
   * @return the content value or "none" if the content is missing
   * @see com.codeborne.selenide.commands.GetPseudoValue
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nonnull
  String pseudo(String pseudoElementName);

  /**
   * Select radio button
   *
   * @param value value of radio button to select
   * @return selected "input type=radio" element
   * @see com.codeborne.selenide.commands.SelectRadio
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement selectRadio(String value);

  /**
   * Get value of attribute "data-dataAttributeName"
   *
   * @see com.codeborne.selenide.commands.GetDataAttribute
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nullable
  String data(String dataAttributeName);

  /**
   * {@inheritDoc}
   * @see NOT RECOMMENDED
   */
  @Override
  @Nullable
  @CheckReturnValue
  String getAttribute(String name);

  /**
   * {@inheritDoc}
   * @see NOT RECOMMENDED
   */
  @Override
  @Nonnull
  @CheckReturnValue
  String getCssValue(String propertyName);

  /**
   * Checks if element exists true on the current page.
   *
   * @return false if element is not found, browser is closed or any WebDriver exception happened
   * @see com.codeborne.selenide.commands.Exists
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  boolean exists();

  /**
   * Check if this element exists and visible.
   *
   * @return false if element does not exists, is invisible, browser is closed or any WebDriver exception happened.
   * @see NOT RECOMMENDED
   */
  @Override
  @CheckReturnValue
  boolean isDisplayed();

  /**
   * 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 #has
   * @see com.codeborne.selenide.commands.Matches
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  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 #is
   * @see com.codeborne.selenide.commands.Matches
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  boolean has(Condition condition);

  /**
   * Set checkbox state to CHECKED or UNCHECKED.
   *
   * @param selected true for checked and false for unchecked
   * @see com.codeborne.selenide.commands.SetSelected
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement setSelected(boolean selected);

  /**
   * 
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 {@link com.codeborne.selenide.Configuration#timeout}
   *
   * For example: {@code
   * $("#errorMessage").should(appear);
   * }
   *
   * @return Given element, useful for chaining:
   * {@code $("#errorMessage").should(appear).shouldBe(enabled);}
   * @see com.codeborne.selenide.Config#timeout
   * @see com.codeborne.selenide.commands.Should
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement should(Condition... condition);

  /**
   * Wait until given element meets given condition (with given timeout)
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement should(Condition condition, Duration timeout);

  /**
   * Synonym for {@link #should(com.codeborne.selenide.Condition...)}. Useful for better readability.
   * For example: {@code
   * $("#errorMessage").shouldHave(text("Hello"), text("World"));
   * }
   *
   * @see SelenideElement#should(com.codeborne.selenide.Condition...)
   * @see com.codeborne.selenide.commands.ShouldHave
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldHave(Condition... condition);

  /**
   * Wait until given element meets given condition (with given timeout)
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldHave(Condition condition, Duration timeout);

  /**
   * Synonym for {@link #should(com.codeborne.selenide.Condition...)}. Useful for better readability.
   * For example: {@code
   * $("#errorMessage").shouldBe(visible, enabled);
   * }
   *
   * @see SelenideElement#should(com.codeborne.selenide.Condition...)
   * @see com.codeborne.selenide.commands.ShouldBe
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldBe(Condition... condition);

  /**
   * Wait until given element meets given condition (with given timeout)
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldBe(Condition condition, Duration timeout);

  /**
   * 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 {@link com.codeborne.selenide.Configuration#timeout}
   *
   * For example: {@code
   * $("#errorMessage").should(exist);
   * }
   *
   * @see com.codeborne.selenide.Config#timeout
   * @see com.codeborne.selenide.commands.ShouldNot
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldNot(Condition... condition);

  /**
   * Wait until given element meets given condition (with given timeout)
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldNot(Condition condition, Duration timeout);

  /**
   * Synonym for {@link #shouldNot(com.codeborne.selenide.Condition...)}. Useful for better readability.
   * For example: {@code
   * $("#errorMessage").shouldNotHave(text("Exception"), text("Error"));
   * }
   *
   * @see SelenideElement#shouldNot(com.codeborne.selenide.Condition...)
   * @see com.codeborne.selenide.commands.ShouldNotHave
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldNotHave(Condition... condition);

  /**
   * Wait until given element does NOT meet given condition (with given timeout)
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldNotHave(Condition condition, Duration timeout);

  /**
   * Synonym for {@link #shouldNot(com.codeborne.selenide.Condition...)}. Useful for better readability.
   * For example: {@code
   * $("#errorMessage").shouldNotBe(visible, enabled);
   * }
   *
   * @see SelenideElement#shouldNot(com.codeborne.selenide.Condition...)
   * @see com.codeborne.selenide.commands.ShouldNotBe
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldNotBe(Condition... condition);

  /**
   * Wait until given element does NOT meet given condition (with given timeout)
   */
  @Nonnull
  @CanIgnoreReturnValue
  SelenideElement shouldNotBe(Condition condition, Duration timeout);

  /**
   * Displays WebElement in human-readable format.
   * Useful for logging and debugging.
   * Not recommended to use for test verifications.
   *
   * @return e.g. Order has been confirmed
   * @see com.codeborne.selenide.commands.ToString
   */
  @Override
  @CheckReturnValue
  @Nonnull
  String toString();

  /**
   * 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).
   *
   * @param alias a human-readable name of this element (null or empty string not allowed)
   * @return this element
   * @see com.codeborne.selenide.commands.As
   * @since 5.17.0
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement as(String alias);

  /**
   * Get parent element of this element (lazy evaluation)
   *
   * For example, $("td").parent() could give some "tr".
   *
   * @return Parent element
   * @see com.codeborne.selenide.commands.GetParent
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement parent();

  /**
   * Get the following sibling element of this element
   *
   * For example, $("td").sibling(0) will give the first following sibling element of "td"
   *
   * @param index the index of sibling element
   * @return Sibling element by index
   * @see com.codeborne.selenide.commands.GetSibling
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement sibling(int index);

  /**
   * Get the preceding sibling element of this element
   *
   * For example, $("td").preceding(0) will give the first preceding sibling element of "td"
   *
   * @param index the index of sibling element
   * @return Sibling element by index
   * @see com.codeborne.selenide.commands.GetPreceding
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement preceding(int index);

  /**
   * Get last child element of this element
   *
   * For example, $("tr").lastChild(); could give the last "td".
   *
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement lastChild();

  /**
   * Locates the closest ancestor element matching given criteria.
   * 

   * For example, $("td").ancestor("table") returns the closest "table" element above "td".
   * 

   * Same as {@code closest("selector", 0)} or {@code closest("selector")}.
   *
   * Examples:
   * 

   * {@code $("td").ancestor("table")} will find the closest ancestor with tag {@code table}
   * 

   * {@code $("td").ancestor(".container")} will find the closest ancestor with CSS class {@code .container}
   * 

   * {@code $("td").ancestor("[data-testid]")} will find the closest ancestor with attribute {@code data-testid}
   * 

   * {@code $("td").ancestor("[data-testid=test-value]")} will find the closest ancestor with attribute and
   * attribute's value {@code data-testid=test-value}
   *

   * @param selector Either HTML tag, CSS class, attribute or attribute with value.

   *                 E.g. {@code form}, {@code .active}, {@code [data-testid]}, {@code [data-testid=test-value]}
   * @return Matching ancestor element
   * @see com.codeborne.selenide.commands.Ancestor
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement ancestor(String selector);

  /**
   * Locates the Nth ancestor element matching given criteria.
   * 

   *
   * Examples:
   * 

   * {@code $("td").ancestor("table", 1)} will find the 2nd ancestor with tag {@code table}
   * 

   * {@code $("td").ancestor(".container", 1)} will find the 2nd ancestor with CSS class {@code .container}
   * 

   * {@code $("td").ancestor("[data-testid]", 1)} will find the 2nd ancestor with attribute {@code data-testid}
   * 

   * {@code $("td").ancestor("[data-testid=test-value]", 1)} will find the 2nd ancestor with attribute and
   * attribute's value {@code data-testid=test-value}
   *

   * @param selector Either HTML tag, CSS class, attribute or attribute with value.

   *                 E.g. {@code form}, {@code .active}, {@code [data-testid]}, {@code [data-testid=test-value]}
   * @param index    0...N index of the ancestor. 0 is the closest, 1 is higher up the hierarchy, etc...
   * @return Matching ancestor element
   * @see com.codeborne.selenide.commands.Ancestor
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement ancestor(String selector, int index);

  /**
   * Same as {@link #ancestor(String)}.
   *
   * Locates the closest ancestor element matching given criteria.
   * 

   * For example, $("td").closest("table") returns the closest "table" element above "td".
   * 

   * Same as {@code ancestor("selector", 0)}.
   *
   * Examples:
   * 

   * {@code $("td").closest("table")} will find the closest ancestor with tag {@code table}
   * 

   * {@code $("td").closest(".container")} will find the closest ancestor with CSS class {@code .container}
   * 

   * {@code $("td").closest("[data-testid]")} will find the closest ancestor with attribute {@code data-testid}
   * 

   * {@code $("td").closest("[data-testid=test-value]")} will find the closest ancestor with attribute and
   * attribute's value {@code data-testid=test-value}
   *

   * @param selector Either HTML tag, CSS class, attribute or attribute with value.

   *                 E.g. {@code form}, {@code .active}, {@code [data-testid]}, {@code [data-testid=test-value]}
   * @return Matching ancestor element
   * @see com.codeborne.selenide.commands.Ancestor
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement closest(String selector);

  /**
   * Locates the first matching element inside given element
   *
   * Short form of {@code webElement.findElement(By.cssSelector(cssSelector))}
   *
   * @see com.codeborne.selenide.commands.Find
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement find(String cssSelector);

  /**
   * Locates the Nth matching element inside given element
   *
   * @see com.codeborne.selenide.commands.Find
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement find(String cssSelector, int index);

  /**
   * Same as {@link #find(String)}
   *
   * @see com.codeborne.selenide.commands.Find
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement find(By selector);

  /**
   * Same as {@link #find(String, int)}
   *
   * @see com.codeborne.selenide.commands.Find
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement find(By selector, int index);

  /**
   * Same as {@link #find(String)}
   *
   * @see com.codeborne.selenide.commands.Find
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement $(String cssSelector);

  /**
   * Same as {@link #find(String, int)}
   *
   * @see com.codeborne.selenide.commands.Find
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement $(String cssSelector, int index);

  /**
   * Same as {@link #find(String)}
   *
   * @see com.codeborne.selenide.commands.Find
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement $(By selector);

  /**
   * Same as {@link #find(String, int)}
   *
   * @see com.codeborne.selenide.commands.Find
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement $(By selector, int index);

  /**
   * Locates the first matching element inside given element using xpath locator
   *
   * Short form of {@code webElement.findElement(By.xpath(xpathLocator))}
   *
   * @see com.codeborne.selenide.commands.FindByXpath
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement $x(String xpath);

  /**
   * Locates the Nth matching element inside given element using xpath locator
   *
   * @see com.codeborne.selenide.commands.FindByXpath
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement $x(String xpath, int index);

  /**
   * 
   * Short form of {@code webDriver.findElements(thisElement, By.cssSelector(cssSelector))}
   * 
   *
   * 
   * For example, {@code $("#multirowTable").findAll("tr.active").shouldHave(size(2));}
   * 
   *
   * @return list of elements inside given element matching given CSS selector
   * @see com.codeborne.selenide.commands.FindAll
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  ElementsCollection findAll(String cssSelector);

  /**
   * 
   * Short form of {@code webDriver.findElements(thisElement, selector)}
   * 
   *
   * 
   * For example, {@code $("#multirowTable").findAll(By.className("active")).shouldHave(size(2));}
   * 
   *
   * @return list of elements inside given element matching given criteria
   * @see com.codeborne.selenide.commands.FindAll
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  ElementsCollection findAll(By selector);

  /**
   * Same as {@link #findAll(String)}
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  ElementsCollection $$(String cssSelector);

  /**
   * Same as {@link #findAll(By)}
   */
  @CheckReturnValue
  @Nonnull
  ElementsCollection $$(By selector);

  /**
   * 
   * Short form of {@code webDriver.findElements(thisElement, By.xpath(xpath))}
   * 
   *
   * 
   * For example, {@code $("#multirowTable").$$x("./input").shouldHave(size(2));}
   * 
   *
   * @return list of elements inside given element matching given xpath locator
   * @see com.codeborne.selenide.commands.FindAllByXpath
   * @see Lazy loading
   */
  @CheckReturnValue
  @Nonnull
  ElementsCollection $$x(String xpath);

  /**
   * 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.
   *
   * @param fileName name of the file or the relative path in classpath e.g. "files/1.pfd"
   * @return the object of the first file uploaded
   * @throws IllegalArgumentException if any of the files is not found
   * @see com.codeborne.selenide.commands.UploadFileFromClasspath
   */
  @Nonnull
  @CanIgnoreReturnValue
  File uploadFromClasspath(String... fileName);

  /**
   * Upload file into file upload field.
   *
   * Multiple file upload is also supported. Just pass as many files as you wish.
   *
   * @param file file object(s)
   * @return the object of the first file uploaded
   * @throws IllegalArgumentException if any of the files is not found, or other errors
   * @see com.codeborne.selenide.commands.UploadFile
   */
  @Nonnull
  @CanIgnoreReturnValue
  File uploadFile(File... file);

  /**
   * Select an option from dropdown list (by index)
   *
   * @param index 0..N (0 means first option)
   * @see com.codeborne.selenide.commands.SelectOptionByTextOrIndex
   */
  void selectOption(int... index);

  /**
   * Select an option from dropdown list (by text)
   *
   * @param text visible text of option
   * @see com.codeborne.selenide.commands.SelectOptionByTextOrIndex
   */
  void selectOption(String... text);

  /**
   * Select an option from dropdown list that contains given text
   *
   * @param text substring of visible text of option
   * @see com.codeborne.selenide.commands.SelectOptionContainingText
   */
  void selectOptionContainingText(String text);

  /**
   * Select an option from dropdown list (by value)
   *
   * @param value "value" attribute of option
   * @see com.codeborne.selenide.commands.SelectOptionByValue
   */
  void selectOptionByValue(String... value);

  /**
   * Find (first) selected option from this select field
   *
   * @return WebElement for selected <option> element
   * @see com.codeborne.selenide.commands.GetSelectedOption
   */
  @CheckReturnValue
  @Nonnull
  SelenideElement getSelectedOption() throws NoSuchElementException;

  /**
   * Find all selected options from this select field
   *
   * @return ElementsCollection for selected <option> elements (empty list if no options are selected)
   * @see com.codeborne.selenide.commands.GetSelectedOptions
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nonnull
  ElementsCollection getSelectedOptions();

  /**
   * Get value of selected option in select field
   *
   * @see GetSelectedOptionValue
   * @return null if the selected option doesn't have "value" attribute (or the select doesn't have options at all)
   * @see NOT RECOMMENDED
   */
  @CheckReturnValue
  @Nullable
  String getSelectedOptionValue();

  /**
   * @deprecated Use {@link #getSelectedOptionValue()} instead
   */
  @Deprecated
  @CheckReturnValue
  @Nullable
  String getSelectedValue();

  /**
   * Get text of selected option in select field
   * @return null if there is no selected options (or the select doesn't have options at all)
   * @throws IllegalArgumentException if the element type is not