Class: Selenium::WebDriver::Support::Select
- Inherits:
-
Object
- Object
- Selenium::WebDriver::Support::Select
- Defined in:
- lib/selenium/webdriver/support/select.rb
Instance Method Summary collapse
-
#deselect_all ⇒ Object
Deselect all selected options.
-
#deselect_by(how, what) ⇒ Object
Deselect options by visible text, index or value.
-
#first_selected_option ⇒ Element
Get the first selected option in this select element.
-
#initialize(element) ⇒ Select
constructor
A new instance of Select.
-
#multiple? ⇒ Boolean
Does this select element support selecting multiple options?.
-
#options ⇒ Array<Element>
Get all options for this select element.
-
#select_all ⇒ Object
Select all unselected options.
-
#select_by(how, what) ⇒ Object
Select options by visible text, index or value.
-
#selected_options ⇒ Array<Element>
Get all selected options for this select element.
Constructor Details
#initialize(element) ⇒ Select
Returns a new instance of Select.
26 27 28 29 30 31 32 33 34 35 |
# File 'lib/selenium/webdriver/support/select.rb', line 26 def initialize(element) tag_name = element.tag_name unless tag_name.casecmp('select').zero? raise ArgumentError, "unexpected tag name #{tag_name.inspect}" end @element = element @multi = ![nil, 'false'].include?(element.attribute(:multiple)) end |
Instance Method Details
#deselect_all ⇒ Object
Deselect all selected options. Only valid if the element supports multiple selections.
156 157 158 159 160 161 162 |
# File 'lib/selenium/webdriver/support/select.rb', line 156 def deselect_all unless multiple? raise Error::UnsupportedOperationError, 'you may only deselect all options of a multi-select' end .each { |e| deselect_option e } end |
#deselect_by(how, what) ⇒ Object
Deselect options by visible text, index or value.
123 124 125 126 127 128 129 130 131 132 133 134 |
# File 'lib/selenium/webdriver/support/select.rb', line 123 def deselect_by(how, what) case how when :text deselect_by_text what when :value deselect_by_value what when :index deselect_by_index what else raise ArgumentError, "can't deselect options by #{how.inspect}" end end |
#first_selected_option ⇒ Element
Get the first selected option in this select element
74 75 76 77 78 |
# File 'lib/selenium/webdriver/support/select.rb', line 74 def first_selected_option option = .find(&:selected?) return option if option raise Error::NoSuchElementError, 'no options are selected' end |
#multiple? ⇒ Boolean
Does this select element support selecting multiple options?
43 44 45 |
# File 'lib/selenium/webdriver/support/select.rb', line 43 def multiple? @multi end |
#options ⇒ Array<Element>
Get all options for this select element
53 54 55 |
# File 'lib/selenium/webdriver/support/select.rb', line 53 def @element.find_elements tag_name: 'option' end |
#select_all ⇒ Object
Select all unselected options. Only valid if the element supports multiple selections.
142 143 144 145 146 147 148 |
# File 'lib/selenium/webdriver/support/select.rb', line 142 def select_all unless multiple? raise Error::UnsupportedOperationError, 'you may only select all options of a multi-select' end .each { |e| select_option e } end |
#select_by(how, what) ⇒ Object
Select options by visible text, index or value.
When selecting by :text, selects options that display text matching the argument. That is, when given “Bar” this would select an option like:
<option value="foo">Bar</option>
When slecting by :value, selects 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>
When selecting by :index, selects the option at the given index. This is done by examining the “index” attribute of an element, and not merely by counting.
100 101 102 103 104 105 106 107 108 109 110 111 |
# File 'lib/selenium/webdriver/support/select.rb', line 100 def select_by(how, what) case how when :text select_by_text what when :index select_by_index what when :value select_by_value what else raise ArgumentError, "can't select options by #{how.inspect}" end end |
#selected_options ⇒ Array<Element>
Get all selected options for this select element
63 64 65 |
# File 'lib/selenium/webdriver/support/select.rb', line 63 def .select(&:selected?) end |