webdriver.support.select

Module Contents

Classes

Select(self,webelement)
class Select(webelement)
__init__(webelement)

Constructor. A check is made that the given element is, indeed, a SELECT tag. If it is not, then an UnexpectedTagNameException is thrown.

Args:
  • webelement - element SELECT element to wrap
Example:
from selenium.webdriver.support.ui import Select n Select(driver.find_element_by_tag_name(“select”)).select_by_index(2)
options()

Returns a list of all options belonging to this select tag

all_selected_options()

Returns a list of all selected options belonging to this select tag

first_selected_option()

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

select_by_value(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>

Args:
  • value - The value to match against

throws NoSuchElementException If there is no option with specisied value in SELECT

select_by_index(index)

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

Args:
  • index - The option at this index will be selected

throws NoSuchElementException If there is no option with specisied index in SELECT

select_by_visible_text(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>
Args:
  • text - The visible text to match against

throws NoSuchElementException If there is no option with specisied text in SELECT

deselect_all()

Clear all selected entries. This is only valid when the SELECT supports multiple selections. throws NotImplementedError If the SELECT does not support multiple selections

deselect_by_value(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>
Args:
  • value - The value to match against

throws NoSuchElementException If there is no option with specisied value in SELECT

deselect_by_index(index)

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

Args:
  • index - The option at this index will be deselected

throws NoSuchElementException If there is no option with specisied index in SELECT

deselect_by_visible_text(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>

Args:
  • text - The visible text to match against
_setSelected(option)
_unsetSelected(option)
_escapeString(value)
_get_longest_token(value)