ru.yandex.qatools.htmlelements.element

Class Select

java.lang.Object

ru.yandex.qatools.htmlelements.element.TypifiedElement

ru.yandex.qatools.htmlelements.element.Select

All Implemented Interfaces:

org.openqa.selenium.SearchContext, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WebElement, org.openqa.selenium.WrapsElement, Named

public class Select
extends TypifiedElement

Represents web page select control.

Actually this class wraps WebDriver Select and delegates all method calls to it. But unlike WebDriver Select class there are no checks performed in the constructor of this class, so it can be used correctly with lazy initialization mechanism.

Author:

Artem Koshelev [email protected], Alexander Tolmachev [email protected]

Constructor Summary

Constructors

Constructor and Description
Select(org.openqa.selenium.WebElement wrappedElement) Specifies wrapped WebElement.

Method Summary

Modifier and Type	Method and Description
void	deselectAll() Clear all selected entries.
void	deselectByIndex(int index) Deselect the option at the given index.
void	deselectByValue(String value) Deselect all options that have a value matching the argument.
void	deselectByVisibleText(String text) Deselect all options that display text matching the argument.
List<org.openqa.selenium.WebElement>	getAllSelectedOptions() Returns all selected options belonging to this select tag.
org.openqa.selenium.WebElement	getFirstSelectedOption() The first selected option in this select tag (or the currently selected option in a normal select).
List<org.openqa.selenium.WebElement>	getOptions() Returns all options belonging to this select tag.
boolean	hasSelectedOption() Indicates if select has at least one selected option.
boolean	isMultiple() Indicates whether this select element support selecting multiple options at the same time.
void	selectByIndex(int index) Select the option at the given index.
void	selectByValue(String value) Select all options that have a value matching the argument.
void	selectByVisibleText(String text) Select all options that display text matching the argument.

Methods inherited from class ru.yandex.qatools.htmlelements.element.TypifiedElement

clear, click, exists, findElement, findElements, getAttribute, getCssValue, getLocation, getName, getRect, getScreenshotAs, getSize, getTagName, getText, getWrappedElement, isDisplayed, isEnabled, isSelected, sendKeys, setName, submit, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Select

public Select(org.openqa.selenium.WebElement wrappedElement)

Specifies wrapped WebElement. Performs no checks unlike Select. All checks are made later in getSelect() method.

Parameters:

wrappedElement - WebElement to wrap.

Method Detail

isMultiple

public boolean isMultiple()

Indicates whether this select element support selecting multiple options at the same time. This is done by checking the value of the "multiple" attribute.

Returns:

true if select element support selecting multiple options and false otherwise.

getOptions

public List<org.openqa.selenium.WebElement> getOptions()

Returns all options belonging to this select tag.

Returns:

A list of WebElements representing options.

getAllSelectedOptions

public List<org.openqa.selenium.WebElement> getAllSelectedOptions()

Returns all selected options belonging to this select tag.

Returns:

A list of WebElements representing selected options.

getFirstSelectedOption

public org.openqa.selenium.WebElement getFirstSelectedOption()

The first selected option in this select tag (or the currently selected option in a normal select).

Returns:

A WebElement representing selected option.

hasSelectedOption

public boolean hasSelectedOption()

Indicates if select has at least one selected option.

Returns:

true if select has at least one selected option and false otherwise.

selectByVisibleText

public void selectByVisibleText(String text)

Select all options that display text matching the argument. That is, when given "Bar" this would select an option like:

<option value="foo">Bar</option>

Parameters:

text - The visible text to match against

selectByIndex

public void selectByIndex(int index)

Select the option at the given index. This is done by examining the "index" attribute of an element, and not merely by counting.

Parameters:

index - The option at this index will be selected

selectByValue

public void selectByValue(String value)

Select all options that have a value matching the argument. That is, when given "foo" this would select an option like:

<option value="foo">Bar</option>

Parameters:

value - The value to match against

deselectAll

public void deselectAll()

Clear all selected entries. This is only valid when the SELECT supports multiple selections.

Throws:

UnsupportedOperationException - If the SELECT does not support multiple selections

deselectByValue

public void deselectByValue(String value)

Deselect all options that have a value matching the argument. That is, when given "foo" this would deselect an option like:

<option value="foo">Bar</option>

Parameters:

value - The value to match against

deselectByIndex

public void deselectByIndex(int index)

Deselect the option at the given index. This is done by examining the "index" attribute of an element, and not merely by counting.

Parameters:

index - The option at this index will be deselected

deselectByVisibleText

public void deselectByVisibleText(String text)

Deselect all options that display text matching the argument. That is, when given "Bar" this would deselect an option like:

<option value="foo">Bar</option>

Parameters:

text - The visible text to match against