watir 6.10.1 → 6.10.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (279) hide show
  1. checksums.yaml +4 -4
  2. data/.document +5 -5
  3. data/.github/ISSUE_TEMPLATE.md +16 -16
  4. data/.gitignore +21 -21
  5. data/.travis.yml +72 -72
  6. data/CHANGES.md +4 -0
  7. data/Gemfile +16 -16
  8. data/LICENSE +23 -23
  9. data/README.md +106 -106
  10. data/Rakefile +153 -153
  11. data/appveyor.yml +13 -13
  12. data/lib/watir-webdriver.rb +2 -2
  13. data/lib/watir.rb +158 -158
  14. data/lib/watir/adjacent.rb +126 -126
  15. data/lib/watir/after_hooks.rb +132 -132
  16. data/lib/watir/alert.rb +120 -120
  17. data/lib/watir/aliases.rb +6 -6
  18. data/lib/watir/attribute_helper.rb +96 -96
  19. data/lib/watir/browser.rb +349 -349
  20. data/lib/watir/capabilities.rb +123 -123
  21. data/lib/watir/cell_container.rb +25 -25
  22. data/lib/watir/container.rb +51 -51
  23. data/lib/watir/cookies.rb +134 -134
  24. data/lib/watir/element_collection.rb +138 -138
  25. data/lib/watir/elements/area.rb +12 -12
  26. data/lib/watir/elements/button.rb +37 -37
  27. data/lib/watir/elements/cell.rb +17 -17
  28. data/lib/watir/elements/checkbox.rb +56 -56
  29. data/lib/watir/elements/dlist.rb +12 -12
  30. data/lib/watir/elements/element.rb +2 -2
  31. data/lib/watir/elements/file_field.rb +41 -41
  32. data/lib/watir/elements/font.rb +25 -25
  33. data/lib/watir/elements/form.rb +16 -16
  34. data/lib/watir/elements/hidden.rb +25 -25
  35. data/lib/watir/elements/html_elements.rb +2035 -2035
  36. data/lib/watir/elements/iframe.rb +166 -166
  37. data/lib/watir/elements/image.rb +21 -21
  38. data/lib/watir/elements/input.rb +15 -15
  39. data/lib/watir/elements/link.rb +18 -18
  40. data/lib/watir/elements/list.rb +49 -49
  41. data/lib/watir/elements/option.rb +72 -72
  42. data/lib/watir/elements/radio.rb +60 -60
  43. data/lib/watir/elements/row.rb +17 -17
  44. data/lib/watir/elements/select.rb +250 -250
  45. data/lib/watir/elements/svg_elements.rb +613 -613
  46. data/lib/watir/elements/table.rb +76 -76
  47. data/lib/watir/elements/table_cell.rb +31 -31
  48. data/lib/watir/elements/table_row.rb +32 -32
  49. data/lib/watir/elements/table_section.rb +15 -15
  50. data/lib/watir/elements/text_area.rb +5 -5
  51. data/lib/watir/elements/text_field.rb +39 -39
  52. data/lib/watir/exception.rb +16 -16
  53. data/lib/watir/extensions/nokogiri.rb +14 -14
  54. data/lib/watir/generator.rb +3 -3
  55. data/lib/watir/generator/base.rb +11 -11
  56. data/lib/watir/generator/base/generator.rb +115 -115
  57. data/lib/watir/generator/base/idl_sorter.rb +47 -47
  58. data/lib/watir/generator/base/spec_extractor.rb +138 -138
  59. data/lib/watir/generator/base/util.rb +21 -21
  60. data/lib/watir/generator/base/visitor.rb +162 -162
  61. data/lib/watir/generator/html.rb +15 -15
  62. data/lib/watir/generator/html/generator.rb +36 -36
  63. data/lib/watir/generator/html/spec_extractor.rb +50 -50
  64. data/lib/watir/generator/html/visitor.rb +21 -21
  65. data/lib/watir/generator/svg.rb +7 -7
  66. data/lib/watir/generator/svg/generator.rb +38 -38
  67. data/lib/watir/generator/svg/spec_extractor.rb +53 -53
  68. data/lib/watir/generator/svg/visitor.rb +21 -21
  69. data/lib/watir/has_window.rb +68 -68
  70. data/lib/watir/js_execution.rb +143 -143
  71. data/lib/watir/js_snippets.rb +16 -16
  72. data/lib/watir/js_snippets/backgroundColor.js +7 -7
  73. data/lib/watir/js_snippets/fireEvent.js +31 -31
  74. data/lib/watir/js_snippets/focus.js +3 -3
  75. data/lib/watir/js_snippets/getInnerHtml.js +19 -19
  76. data/lib/watir/js_snippets/getInnerText.js +19 -19
  77. data/lib/watir/js_snippets/getOuterHtml.js +20 -20
  78. data/lib/watir/js_snippets/getTextContent.js +19 -19
  79. data/lib/watir/js_snippets/isImageLoaded.js +3 -3
  80. data/lib/watir/js_snippets/selectOptionsLabel.js +10 -10
  81. data/lib/watir/js_snippets/selectOptionsText.js +10 -10
  82. data/lib/watir/js_snippets/selectOptionsValue.js +10 -10
  83. data/lib/watir/js_snippets/selectText.js +64 -64
  84. data/lib/watir/js_snippets/selectedOptions.js +11 -11
  85. data/lib/watir/js_snippets/setValue.js +3 -3
  86. data/lib/watir/legacy_wait.rb +126 -126
  87. data/lib/watir/locators.rb +60 -60
  88. data/lib/watir/locators/button/locator.rb +31 -31
  89. data/lib/watir/locators/button/selector_builder.rb +30 -30
  90. data/lib/watir/locators/button/selector_builder/xpath.rb +29 -29
  91. data/lib/watir/locators/button/validator.rb +15 -15
  92. data/lib/watir/locators/cell/locator.rb +15 -15
  93. data/lib/watir/locators/cell/selector_builder.rb +24 -24
  94. data/lib/watir/locators/element/selector_builder.rb +150 -150
  95. data/lib/watir/locators/element/selector_builder/xpath.rb +119 -119
  96. data/lib/watir/locators/element/validator.rb +18 -18
  97. data/lib/watir/locators/row/locator.rb +15 -15
  98. data/lib/watir/locators/row/selector_builder.rb +29 -29
  99. data/lib/watir/locators/text_area/locator.rb +13 -13
  100. data/lib/watir/locators/text_area/selector_builder.rb +22 -22
  101. data/lib/watir/locators/text_field/locator.rb +30 -30
  102. data/lib/watir/locators/text_field/selector_builder.rb +31 -31
  103. data/lib/watir/locators/text_field/selector_builder/xpath.rb +17 -17
  104. data/lib/watir/locators/text_field/validator.rb +12 -12
  105. data/lib/watir/logger.rb +109 -109
  106. data/lib/watir/radio_set.rb +231 -231
  107. data/lib/watir/row_container.rb +36 -36
  108. data/lib/watir/screenshot.rb +50 -50
  109. data/lib/watir/user_editable.rb +56 -56
  110. data/lib/watir/wait.rb +200 -200
  111. data/lib/watir/wait/timer.rb +52 -52
  112. data/lib/watir/window.rb +257 -257
  113. data/lib/watir/xpath_support.rb +20 -20
  114. data/lib/watirspec.rb +86 -86
  115. data/lib/watirspec/guards.rb +60 -60
  116. data/lib/watirspec/implementation.rb +51 -51
  117. data/lib/watirspec/rake_tasks.rb +115 -115
  118. data/lib/watirspec/remote_server.rb +38 -38
  119. data/lib/watirspec/runner.rb +53 -53
  120. data/lib/watirspec/server.rb +99 -99
  121. data/lib/watirspec/server/app.rb +76 -76
  122. data/spec/browser_spec.rb +278 -278
  123. data/spec/click_spec.rb +19 -19
  124. data/spec/container_spec.rb +34 -34
  125. data/spec/element_locator_spec.rb +517 -517
  126. data/spec/element_spec.rb +158 -158
  127. data/spec/implementation_spec.rb +24 -24
  128. data/spec/input_spec.rb +14 -14
  129. data/spec/locator_spec_helper.rb +55 -55
  130. data/spec/logger_spec.rb +46 -46
  131. data/spec/spec_helper.rb +22 -22
  132. data/spec/special_chars_spec.rb +13 -13
  133. data/spec/watirspec/adjacent_spec.rb +227 -227
  134. data/spec/watirspec/after_hooks_spec.rb +182 -182
  135. data/spec/watirspec/alert_spec.rb +108 -108
  136. data/spec/watirspec/attributes_spec.rb +16 -16
  137. data/spec/watirspec/browser_spec.rb +281 -281
  138. data/spec/watirspec/cookies_spec.rb +154 -154
  139. data/spec/watirspec/drag_and_drop_spec.rb +49 -49
  140. data/spec/watirspec/element_hidden_spec.rb +75 -75
  141. data/spec/watirspec/elements/area_spec.rb +72 -72
  142. data/spec/watirspec/elements/areas_spec.rb +42 -42
  143. data/spec/watirspec/elements/button_spec.rb +277 -277
  144. data/spec/watirspec/elements/buttons_spec.rb +55 -55
  145. data/spec/watirspec/elements/checkbox_spec.rb +275 -275
  146. data/spec/watirspec/elements/checkboxes_spec.rb +44 -44
  147. data/spec/watirspec/elements/collections_spec.rb +52 -52
  148. data/spec/watirspec/elements/dd_spec.rb +124 -124
  149. data/spec/watirspec/elements/dds_spec.rb +42 -42
  150. data/spec/watirspec/elements/del_spec.rb +126 -126
  151. data/spec/watirspec/elements/dels_spec.rb +40 -40
  152. data/spec/watirspec/elements/div_spec.rb +245 -245
  153. data/spec/watirspec/elements/divs_spec.rb +42 -42
  154. data/spec/watirspec/elements/dl_spec.rb +142 -142
  155. data/spec/watirspec/elements/dls_spec.rb +43 -43
  156. data/spec/watirspec/elements/dt_spec.rb +122 -122
  157. data/spec/watirspec/elements/dts_spec.rb +42 -42
  158. data/spec/watirspec/elements/element_spec.rb +483 -483
  159. data/spec/watirspec/elements/elements_spec.rb +47 -47
  160. data/spec/watirspec/elements/em_spec.rb +96 -96
  161. data/spec/watirspec/elements/ems_spec.rb +43 -43
  162. data/spec/watirspec/elements/filefield_spec.rb +170 -170
  163. data/spec/watirspec/elements/filefields_spec.rb +43 -43
  164. data/spec/watirspec/elements/font_spec.rb +29 -29
  165. data/spec/watirspec/elements/form_spec.rb +66 -66
  166. data/spec/watirspec/elements/forms_spec.rb +46 -46
  167. data/spec/watirspec/elements/frame_spec.rb +123 -123
  168. data/spec/watirspec/elements/frames_spec.rb +41 -41
  169. data/spec/watirspec/elements/hidden_spec.rb +104 -104
  170. data/spec/watirspec/elements/hiddens_spec.rb +43 -43
  171. data/spec/watirspec/elements/hn_spec.rb +92 -92
  172. data/spec/watirspec/elements/hns_spec.rb +38 -38
  173. data/spec/watirspec/elements/iframe_spec.rb +3 -0
  174. data/spec/watirspec/elements/iframes_spec.rb +47 -47
  175. data/spec/watirspec/elements/image_spec.rb +158 -158
  176. data/spec/watirspec/elements/images_spec.rb +40 -40
  177. data/spec/watirspec/elements/ins_spec.rb +127 -127
  178. data/spec/watirspec/elements/inses_spec.rb +40 -40
  179. data/spec/watirspec/elements/label_spec.rb +75 -75
  180. data/spec/watirspec/elements/labels_spec.rb +40 -40
  181. data/spec/watirspec/elements/li_spec.rb +111 -111
  182. data/spec/watirspec/elements/link_spec.rb +171 -171
  183. data/spec/watirspec/elements/links_spec.rb +44 -44
  184. data/spec/watirspec/elements/lis_spec.rb +42 -42
  185. data/spec/watirspec/elements/list_spec.rb +32 -32
  186. data/spec/watirspec/elements/map_spec.rb +75 -75
  187. data/spec/watirspec/elements/maps_spec.rb +41 -41
  188. data/spec/watirspec/elements/meta_spec.rb +23 -23
  189. data/spec/watirspec/elements/metas_spec.rb +40 -40
  190. data/spec/watirspec/elements/ol_spec.rb +87 -87
  191. data/spec/watirspec/elements/ols_spec.rb +40 -40
  192. data/spec/watirspec/elements/option_spec.rb +121 -121
  193. data/spec/watirspec/elements/p_spec.rb +111 -111
  194. data/spec/watirspec/elements/pre_spec.rb +111 -111
  195. data/spec/watirspec/elements/pres_spec.rb +40 -40
  196. data/spec/watirspec/elements/ps_spec.rb +40 -40
  197. data/spec/watirspec/elements/radio_spec.rb +273 -273
  198. data/spec/watirspec/elements/radios_spec.rb +43 -43
  199. data/spec/watirspec/elements/select_list_spec.rb +553 -553
  200. data/spec/watirspec/elements/select_lists_spec.rb +46 -46
  201. data/spec/watirspec/elements/span_spec.rb +128 -128
  202. data/spec/watirspec/elements/spans_spec.rb +40 -40
  203. data/spec/watirspec/elements/strong_spec.rb +88 -88
  204. data/spec/watirspec/elements/strongs_spec.rb +43 -43
  205. data/spec/watirspec/elements/table_nesting_spec.rb +51 -51
  206. data/spec/watirspec/elements/table_spec.rb +156 -156
  207. data/spec/watirspec/elements/tables_spec.rb +42 -42
  208. data/spec/watirspec/elements/tbody_spec.rb +93 -93
  209. data/spec/watirspec/elements/tbodys_spec.rb +62 -62
  210. data/spec/watirspec/elements/td_spec.rb +93 -93
  211. data/spec/watirspec/elements/tds_spec.rb +53 -53
  212. data/spec/watirspec/elements/text_field_spec.rb +360 -360
  213. data/spec/watirspec/elements/text_fields_spec.rb +44 -44
  214. data/spec/watirspec/elements/textarea_spec.rb +26 -26
  215. data/spec/watirspec/elements/textareas_spec.rb +24 -24
  216. data/spec/watirspec/elements/tfoot_spec.rb +86 -86
  217. data/spec/watirspec/elements/tfoots_spec.rb +68 -68
  218. data/spec/watirspec/elements/thead_spec.rb +86 -86
  219. data/spec/watirspec/elements/theads_spec.rb +68 -68
  220. data/spec/watirspec/elements/tr_spec.rb +78 -78
  221. data/spec/watirspec/elements/trs_spec.rb +61 -61
  222. data/spec/watirspec/elements/ul_spec.rb +76 -76
  223. data/spec/watirspec/elements/uls_spec.rb +39 -39
  224. data/spec/watirspec/html/alerts.html +12 -12
  225. data/spec/watirspec/html/aria_attributes.html +9 -9
  226. data/spec/watirspec/html/class_locator.html +8 -8
  227. data/spec/watirspec/html/clicks.html +19 -19
  228. data/spec/watirspec/html/closeable.html +12 -12
  229. data/spec/watirspec/html/collections.html +14 -14
  230. data/spec/watirspec/html/css/jquery-ui-1.8.17.custom.css +286 -286
  231. data/spec/watirspec/html/data_attributes.html +9 -9
  232. data/spec/watirspec/html/definition_lists.html +47 -47
  233. data/spec/watirspec/html/drag_and_drop.html +106 -106
  234. data/spec/watirspec/html/font.html +10 -10
  235. data/spec/watirspec/html/forms_with_input_elements.html +174 -174
  236. data/spec/watirspec/html/frame_1.html +22 -22
  237. data/spec/watirspec/html/frame_2.html +15 -15
  238. data/spec/watirspec/html/frames.html +10 -10
  239. data/spec/watirspec/html/hover.html +11 -11
  240. data/spec/watirspec/html/iframe_1.html +22 -22
  241. data/spec/watirspec/html/iframes.html +12 -12
  242. data/spec/watirspec/html/images.html +27 -27
  243. data/spec/watirspec/html/inner_outer.html +4 -4
  244. data/spec/watirspec/html/javascript/angular.min.js +331 -331
  245. data/spec/watirspec/html/javascript/helpers.js +16 -16
  246. data/spec/watirspec/html/javascript/jquery-1.7.1.min.js +3 -3
  247. data/spec/watirspec/html/javascript/jquery-ui-1.8.17.custom.min.js +67 -67
  248. data/spec/watirspec/html/keylogger.html +14 -14
  249. data/spec/watirspec/html/modal_dialog.html +9 -9
  250. data/spec/watirspec/html/multiple_ids.html +14 -14
  251. data/spec/watirspec/html/nested_elements.html +33 -33
  252. data/spec/watirspec/html/nested_frame_2.html +9 -9
  253. data/spec/watirspec/html/nested_frame_3.html +14 -14
  254. data/spec/watirspec/html/nested_frames.html +10 -10
  255. data/spec/watirspec/html/nested_iframe_2.html +12 -12
  256. data/spec/watirspec/html/nested_iframes.html +13 -13
  257. data/spec/watirspec/html/nested_tables.html +202 -202
  258. data/spec/watirspec/html/non_control_elements.html +140 -140
  259. data/spec/watirspec/html/removed_element.html +24 -24
  260. data/spec/watirspec/html/right_click.html +10 -10
  261. data/spec/watirspec/html/special_chars.html +11 -11
  262. data/spec/watirspec/html/tables.html +120 -120
  263. data/spec/watirspec/html/timeout_window_location.html +19 -19
  264. data/spec/watirspec/html/uneven_table.html +20 -20
  265. data/spec/watirspec/html/wait.html +84 -84
  266. data/spec/watirspec/html/window_switching.html +11 -11
  267. data/spec/watirspec/radio_set_spec.rb +336 -336
  268. data/spec/watirspec/relaxed_locate_spec.rb +99 -99
  269. data/spec/watirspec/screenshot_spec.rb +29 -29
  270. data/spec/watirspec/support/raise_exception_matchers.rb +36 -36
  271. data/spec/watirspec/wait_spec.rb +381 -381
  272. data/spec/watirspec/window_switching_spec.rb +415 -415
  273. data/spec/watirspec_helper.rb +161 -161
  274. data/support/appveyor.cmd +9 -9
  275. data/support/doctest_helper.rb +101 -101
  276. data/support/travis.sh +11 -11
  277. data/support/version_differ.rb +59 -59
  278. data/watir.gemspec +1 -1
  279. metadata +169 -3
@@ -1,72 +1,72 @@
1
- module Watir
2
-
3
- #
4
- # Represents an option in a select list.
5
- #
6
-
7
- class Option < HTMLElement
8
-
9
- #
10
- # Selects this option.
11
- #
12
- # @example
13
- # browser.select(id: "foo").options.first.select
14
- #
15
-
16
- alias_method :select, :click
17
-
18
- #
19
- # Toggles the selected state of this option.
20
- #
21
- # @example
22
- # browser.select(id: "foo").options.first.toggle
23
- #
24
-
25
- alias_method :toggle, :click
26
-
27
- #
28
- # Clears (i.e. toggles selected state) option.
29
- #
30
- # @example
31
- # browser.select(id: "foo").options.first.clear
32
- #
33
-
34
- def clear
35
- click if selected?
36
- end
37
-
38
- #
39
- # Is this option selected?
40
- #
41
- # @return [Boolean]
42
- #
43
-
44
- def selected?
45
- element_call { @element.selected? }
46
- end
47
-
48
- #
49
- # Returns the text of option.
50
- #
51
- # Note that the text is either one of the following respectively:
52
- # * label attribute
53
- # * text attribute
54
- # * inner element text
55
- #
56
- # @return [String]
57
- #
58
-
59
- def text
60
- # A little unintuitive - we'll return the 'label' or 'text' attribute if
61
- # they exist, otherwise the inner text of the element
62
-
63
- [:label, :text].each do |a|
64
- val = attribute_value(a)
65
- return val unless val.nil?
66
- end
67
-
68
- super
69
- end
70
-
71
- end # Option
72
- end # Watir
1
+ module Watir
2
+
3
+ #
4
+ # Represents an option in a select list.
5
+ #
6
+
7
+ class Option < HTMLElement
8
+
9
+ #
10
+ # Selects this option.
11
+ #
12
+ # @example
13
+ # browser.select(id: "foo").options.first.select
14
+ #
15
+
16
+ alias_method :select, :click
17
+
18
+ #
19
+ # Toggles the selected state of this option.
20
+ #
21
+ # @example
22
+ # browser.select(id: "foo").options.first.toggle
23
+ #
24
+
25
+ alias_method :toggle, :click
26
+
27
+ #
28
+ # Clears (i.e. toggles selected state) option.
29
+ #
30
+ # @example
31
+ # browser.select(id: "foo").options.first.clear
32
+ #
33
+
34
+ def clear
35
+ click if selected?
36
+ end
37
+
38
+ #
39
+ # Is this option selected?
40
+ #
41
+ # @return [Boolean]
42
+ #
43
+
44
+ def selected?
45
+ element_call { @element.selected? }
46
+ end
47
+
48
+ #
49
+ # Returns the text of option.
50
+ #
51
+ # Note that the text is either one of the following respectively:
52
+ # * label attribute
53
+ # * text attribute
54
+ # * inner element text
55
+ #
56
+ # @return [String]
57
+ #
58
+
59
+ def text
60
+ # A little unintuitive - we'll return the 'label' or 'text' attribute if
61
+ # they exist, otherwise the inner text of the element
62
+
63
+ [:label, :text].each do |a|
64
+ val = attribute_value(a)
65
+ return val unless val.nil?
66
+ end
67
+
68
+ super
69
+ end
70
+
71
+ end # Option
72
+ end # Watir
@@ -1,60 +1,60 @@
1
- module Watir
2
- class Radio < Input
3
-
4
- def initialize(query_scope, selector)
5
- super
6
- @selector[:label] = @selector.delete(:text) if @selector.key?(:text)
7
- end
8
-
9
- #
10
- # Selects this radio button.
11
- #
12
-
13
- def set
14
- click unless set?
15
- end
16
- alias_method :select, :set
17
-
18
- #
19
- # Is this radio set?
20
- #
21
- # @return [Boolean]
22
- #
23
-
24
- def set?
25
- element_call { @element.selected? }
26
- end
27
- alias_method :selected?, :set?
28
-
29
- #
30
- # Returns the text of the associated label.
31
- # Returns empty string if no label is found.
32
- #
33
- # @return [String]
34
- #
35
-
36
- def text
37
- l = label()
38
- l.exist? ? l.text : ''
39
- end
40
-
41
- end # Radio
42
-
43
- module Container
44
- def radio(*args)
45
- Radio.new(self, extract_selector(args).merge(tag_name: "input", type: "radio"))
46
- end
47
-
48
- def radios(*args)
49
- RadioCollection.new(self, extract_selector(args).merge(tag_name: "input", type: "radio" ))
50
- end
51
- end # Container
52
-
53
- class RadioCollection < InputCollection
54
- private
55
-
56
- def element_class
57
- Radio
58
- end
59
- end # RadioCollection
60
- end # Watir
1
+ module Watir
2
+ class Radio < Input
3
+
4
+ def initialize(query_scope, selector)
5
+ super
6
+ @selector[:label] = @selector.delete(:text) if @selector.key?(:text)
7
+ end
8
+
9
+ #
10
+ # Selects this radio button.
11
+ #
12
+
13
+ def set
14
+ click unless set?
15
+ end
16
+ alias_method :select, :set
17
+
18
+ #
19
+ # Is this radio set?
20
+ #
21
+ # @return [Boolean]
22
+ #
23
+
24
+ def set?
25
+ element_call { @element.selected? }
26
+ end
27
+ alias_method :selected?, :set?
28
+
29
+ #
30
+ # Returns the text of the associated label.
31
+ # Returns empty string if no label is found.
32
+ #
33
+ # @return [String]
34
+ #
35
+
36
+ def text
37
+ l = label()
38
+ l.exist? ? l.text : ''
39
+ end
40
+
41
+ end # Radio
42
+
43
+ module Container
44
+ def radio(*args)
45
+ Radio.new(self, extract_selector(args).merge(tag_name: "input", type: "radio"))
46
+ end
47
+
48
+ def radios(*args)
49
+ RadioCollection.new(self, extract_selector(args).merge(tag_name: "input", type: "radio" ))
50
+ end
51
+ end # Container
52
+
53
+ class RadioCollection < InputCollection
54
+ private
55
+
56
+ def element_class
57
+ Radio
58
+ end
59
+ end # RadioCollection
60
+ end # Watir
@@ -1,17 +1,17 @@
1
- module Watir
2
-
3
- #
4
- # Custom class representing table row (tr).
5
- #
6
-
7
- class Row < TableRow
8
- end # Row
9
-
10
- class RowCollection < TableRowCollection
11
- def to_a
12
- # we do this craziness since the xpath used will find direct child rows
13
- # before any rows inside thead/tbody/tfoot...
14
- @to_a ||= super.sort_by { |e| e.attribute_value(:rowIndex).to_i }
15
- end
16
- end
17
- end # Watir
1
+ module Watir
2
+
3
+ #
4
+ # Custom class representing table row (tr).
5
+ #
6
+
7
+ class Row < TableRow
8
+ end # Row
9
+
10
+ class RowCollection < TableRowCollection
11
+ def to_a
12
+ # we do this craziness since the xpath used will find direct child rows
13
+ # before any rows inside thead/tbody/tfoot...
14
+ @to_a ||= super.sort_by { |e| e.attribute_value(:rowIndex).to_i }
15
+ end
16
+ end
17
+ end # Watir
@@ -1,250 +1,250 @@
1
- module Watir
2
- class Select < HTMLElement
3
- include Watir::Exception
4
-
5
- #
6
- # Clears all selected options.
7
- #
8
-
9
- def clear
10
- raise Error, "you can only clear multi-selects" unless multiple?
11
-
12
- selected_options.each(&:click)
13
- end
14
-
15
- #
16
- # Gets all the options in the select list
17
- #
18
- # @return [Watir::OptionCollection]
19
- #
20
-
21
- def options(*)
22
- element_call(:wait_for_present) { super }
23
- end
24
-
25
- #
26
- # Returns true if the select list has one or more options where text or label matches the given value.
27
- #
28
- # @param [String, Regexp] str_or_rx
29
- # @return [Boolean]
30
- #
31
-
32
- def include?(str_or_rx)
33
- option(text: str_or_rx).exist? || option(label: str_or_rx).exist?
34
- end
35
-
36
- #
37
- # Select the option whose text or label matches the given string.
38
- #
39
- # @param [String, Regexp] str_or_rx
40
- # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
41
- # @return [String] The text of the option selected. If multiple options match, returns the first match.
42
- #
43
-
44
- def select(*str_or_rx)
45
- results = str_or_rx.flatten.map { |v| select_by v}
46
- results.first
47
- end
48
-
49
- #
50
- # Select all options whose text or label matches the given string.
51
- #
52
- # @param [String, Regexp] str_or_rx
53
- # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
54
- # @return [String] The text of the first option selected.
55
- #
56
-
57
- def select_all(*str_or_rx)
58
- results = str_or_rx.flatten.map { |v| select_all_by v }
59
- results.first
60
- end
61
-
62
- #
63
- # Uses JavaScript to select the option whose text matches the given string.
64
- #
65
- # @param [String, Regexp] str_or_rx
66
- # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
67
- #
68
-
69
- def select!(*str_or_rx)
70
- results = str_or_rx.flatten.map { |v| select_by!(v, :single) }
71
- results.first
72
- end
73
-
74
- #
75
- # Uses JavaScript to select all options whose text matches the given string.
76
- #
77
- # @param [String, Regexp] str_or_rx
78
- # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
79
- #
80
-
81
- def select_all!(*str_or_rx)
82
- results = str_or_rx.flatten.map { |v| select_by!(v, :multiple) }
83
- results.first
84
- end
85
-
86
- #
87
- # Selects the option(s) whose value attribute matches the given string.
88
- #
89
- # @see +select+
90
- #
91
- # @param [String, Regexp] str_or_rx
92
- # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
93
- # @return [String] The option selected. If multiple options match, returns the first match
94
- #
95
-
96
- def select_value(str_or_rx)
97
- Watir.logger.deprecate '#select_value', "#select"
98
- select_by str_or_rx
99
- end
100
-
101
- #
102
- # Returns true if any of the selected options' text or label matches the given value.
103
- #
104
- # @param [String, Regexp] str_or_rx
105
- # @raise [Watir::Exception::UnknownObjectException] if the options do not exist
106
- # @return [Boolean]
107
- #
108
-
109
- def selected?(str_or_rx)
110
- by_text = options(text: str_or_rx)
111
- return true if by_text.find(&:selected?)
112
-
113
- by_label = options(label: str_or_rx)
114
- return true if by_label.find(&:selected?)
115
-
116
- return false unless by_text.size + by_label.size == 0
117
-
118
- raise(UnknownObjectException, "Unable to locate option matching #{str_or_rx.inspect}")
119
- end
120
-
121
- #
122
- # Returns the value of the first selected option in the select list.
123
- # Returns nil if no option is selected.
124
- #
125
- # @return [String, nil]
126
- #
127
-
128
- def value
129
- option = selected_options.first
130
- option && option.value
131
- end
132
-
133
- #
134
- # Returns the text of the first selected option in the select list.
135
- # Returns nil if no option is selected.
136
- #
137
- # @return [String, nil]
138
- #
139
-
140
- def text
141
- option = selected_options.first
142
- option && option.text
143
- end
144
-
145
- # Returns an array of currently selected options.
146
- #
147
- # @return [Array<Watir::Option>]
148
- #
149
-
150
- def selected_options
151
- element_call { execute_js :selectedOptions, self }
152
- end
153
-
154
- private
155
-
156
- def select_by(str_or_rx)
157
- found = find_options(:value, str_or_rx)
158
-
159
- if found && found.size > 1
160
- Watir.logger.deprecate "Selecting Multiple Options with #select", "#select_all"
161
- end
162
- return select_matching(found) if found && found.any?
163
- raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
164
- end
165
-
166
- def select_by!(str_or_rx, number)
167
- js_rx = case str_or_rx
168
- when String
169
- "^#{str_or_rx}$"
170
- when Regexp
171
- str_or_rx.inspect.sub('\\A', '^').sub('\\Z', '$').sub('\\z', '$').sub(/^\//, '').sub(/\/[a-z]*$/, '')
172
- .gsub(/\(\?#.+\)/, '').gsub(/\(\?-\w+:/, '(')
173
- else
174
- raise TypeError, "expected String or Regexp, got #{str_or_rx.inspect}:#{str_or_rx.class}"
175
- end
176
-
177
- element_call { execute_js(:selectOptionsText, self, js_rx, number.to_s) }
178
- return selected_options.first.text if matching_option?(:text, str_or_rx)
179
-
180
- element_call { execute_js(:selectOptionsLabel, self, js_rx, number.to_s) }
181
- return selected_options.first.text if matching_option?(:label, str_or_rx)
182
-
183
- element_call { execute_js(:selectOptionsValue, self, js_rx, number.to_s) }
184
- return selected_options.first.text if matching_option?(:value, str_or_rx)
185
-
186
- raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
187
- end
188
-
189
- def matching_option?(how, what)
190
- selected_options.each do |opt|
191
- value = opt.send(how)
192
- if what.is_a?(String) ? value == what : value =~ what
193
- return true if opt.enabled?
194
- raise Watir::Exception::ObjectDisabledException, "option matching #{what} by #{how} on #{inspect} is disabled"
195
- end
196
- end
197
- false
198
- end
199
-
200
- def select_all_by(str_or_rx)
201
- raise Error, "you can only use #select_all on multi-selects" unless multiple?
202
- found = find_options :text, str_or_rx
203
-
204
- return select_matching(found) if found
205
- raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
206
- end
207
-
208
- def find_options(how, str_or_rx)
209
- browser.wait_while do
210
- case str_or_rx
211
- when String, Numeric, Regexp
212
- @found = how == :value ? options(value: str_or_rx) : []
213
- @found = options(text: str_or_rx) if @found.empty?
214
- @found = options(label: str_or_rx) if @found.empty?
215
- @found.empty? && Watir.relaxed_locate?
216
- else
217
- raise TypeError, "expected String or Regexp, got #{str_or_rx.inspect}:#{str_or_rx.class}"
218
- end
219
- end
220
- return @found unless @found.empty?
221
- raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
222
- rescue Wait::TimeoutError
223
- raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
224
- end
225
-
226
- def select_matching(elements)
227
- elements = [elements.first] unless multiple?
228
- elements.each { |e| e.click unless e.selected? }
229
- elements.first.exist? ? elements.first.text : ''
230
- end
231
-
232
- def matches_regexp?(how, element, exp)
233
- case how
234
- when :text
235
- element.text =~ exp || element.label =~ exp
236
- when :value
237
- element.value =~ exp
238
- else
239
- raise Error, "unknown how: #{how.inspect}"
240
- end
241
- end
242
- end # Select
243
-
244
- module Container
245
- alias_method :select_list, :select
246
- alias_method :select_lists, :selects
247
-
248
- Watir.tag_to_class[:select_list] = Select
249
- end # Container
250
- end # Watir
1
+ module Watir
2
+ class Select < HTMLElement
3
+ include Watir::Exception
4
+
5
+ #
6
+ # Clears all selected options.
7
+ #
8
+
9
+ def clear
10
+ raise Error, "you can only clear multi-selects" unless multiple?
11
+
12
+ selected_options.each(&:click)
13
+ end
14
+
15
+ #
16
+ # Gets all the options in the select list
17
+ #
18
+ # @return [Watir::OptionCollection]
19
+ #
20
+
21
+ def options(*)
22
+ element_call(:wait_for_present) { super }
23
+ end
24
+
25
+ #
26
+ # Returns true if the select list has one or more options where text or label matches the given value.
27
+ #
28
+ # @param [String, Regexp] str_or_rx
29
+ # @return [Boolean]
30
+ #
31
+
32
+ def include?(str_or_rx)
33
+ option(text: str_or_rx).exist? || option(label: str_or_rx).exist?
34
+ end
35
+
36
+ #
37
+ # Select the option whose text or label matches the given string.
38
+ #
39
+ # @param [String, Regexp] str_or_rx
40
+ # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
41
+ # @return [String] The text of the option selected. If multiple options match, returns the first match.
42
+ #
43
+
44
+ def select(*str_or_rx)
45
+ results = str_or_rx.flatten.map { |v| select_by v}
46
+ results.first
47
+ end
48
+
49
+ #
50
+ # Select all options whose text or label matches the given string.
51
+ #
52
+ # @param [String, Regexp] str_or_rx
53
+ # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
54
+ # @return [String] The text of the first option selected.
55
+ #
56
+
57
+ def select_all(*str_or_rx)
58
+ results = str_or_rx.flatten.map { |v| select_all_by v }
59
+ results.first
60
+ end
61
+
62
+ #
63
+ # Uses JavaScript to select the option whose text matches the given string.
64
+ #
65
+ # @param [String, Regexp] str_or_rx
66
+ # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
67
+ #
68
+
69
+ def select!(*str_or_rx)
70
+ results = str_or_rx.flatten.map { |v| select_by!(v, :single) }
71
+ results.first
72
+ end
73
+
74
+ #
75
+ # Uses JavaScript to select all options whose text matches the given string.
76
+ #
77
+ # @param [String, Regexp] str_or_rx
78
+ # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
79
+ #
80
+
81
+ def select_all!(*str_or_rx)
82
+ results = str_or_rx.flatten.map { |v| select_by!(v, :multiple) }
83
+ results.first
84
+ end
85
+
86
+ #
87
+ # Selects the option(s) whose value attribute matches the given string.
88
+ #
89
+ # @see +select+
90
+ #
91
+ # @param [String, Regexp] str_or_rx
92
+ # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
93
+ # @return [String] The option selected. If multiple options match, returns the first match
94
+ #
95
+
96
+ def select_value(str_or_rx)
97
+ Watir.logger.deprecate '#select_value', "#select"
98
+ select_by str_or_rx
99
+ end
100
+
101
+ #
102
+ # Returns true if any of the selected options' text or label matches the given value.
103
+ #
104
+ # @param [String, Regexp] str_or_rx
105
+ # @raise [Watir::Exception::UnknownObjectException] if the options do not exist
106
+ # @return [Boolean]
107
+ #
108
+
109
+ def selected?(str_or_rx)
110
+ by_text = options(text: str_or_rx)
111
+ return true if by_text.find(&:selected?)
112
+
113
+ by_label = options(label: str_or_rx)
114
+ return true if by_label.find(&:selected?)
115
+
116
+ return false unless by_text.size + by_label.size == 0
117
+
118
+ raise(UnknownObjectException, "Unable to locate option matching #{str_or_rx.inspect}")
119
+ end
120
+
121
+ #
122
+ # Returns the value of the first selected option in the select list.
123
+ # Returns nil if no option is selected.
124
+ #
125
+ # @return [String, nil]
126
+ #
127
+
128
+ def value
129
+ option = selected_options.first
130
+ option && option.value
131
+ end
132
+
133
+ #
134
+ # Returns the text of the first selected option in the select list.
135
+ # Returns nil if no option is selected.
136
+ #
137
+ # @return [String, nil]
138
+ #
139
+
140
+ def text
141
+ option = selected_options.first
142
+ option && option.text
143
+ end
144
+
145
+ # Returns an array of currently selected options.
146
+ #
147
+ # @return [Array<Watir::Option>]
148
+ #
149
+
150
+ def selected_options
151
+ element_call { execute_js :selectedOptions, self }
152
+ end
153
+
154
+ private
155
+
156
+ def select_by(str_or_rx)
157
+ found = find_options(:value, str_or_rx)
158
+
159
+ if found && found.size > 1
160
+ Watir.logger.deprecate "Selecting Multiple Options with #select", "#select_all"
161
+ end
162
+ return select_matching(found) if found && found.any?
163
+ raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
164
+ end
165
+
166
+ def select_by!(str_or_rx, number)
167
+ js_rx = case str_or_rx
168
+ when String
169
+ "^#{str_or_rx}$"
170
+ when Regexp
171
+ str_or_rx.inspect.sub('\\A', '^').sub('\\Z', '$').sub('\\z', '$').sub(/^\//, '').sub(/\/[a-z]*$/, '')
172
+ .gsub(/\(\?#.+\)/, '').gsub(/\(\?-\w+:/, '(')
173
+ else
174
+ raise TypeError, "expected String or Regexp, got #{str_or_rx.inspect}:#{str_or_rx.class}"
175
+ end
176
+
177
+ element_call { execute_js(:selectOptionsText, self, js_rx, number.to_s) }
178
+ return selected_options.first.text if matching_option?(:text, str_or_rx)
179
+
180
+ element_call { execute_js(:selectOptionsLabel, self, js_rx, number.to_s) }
181
+ return selected_options.first.text if matching_option?(:label, str_or_rx)
182
+
183
+ element_call { execute_js(:selectOptionsValue, self, js_rx, number.to_s) }
184
+ return selected_options.first.text if matching_option?(:value, str_or_rx)
185
+
186
+ raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
187
+ end
188
+
189
+ def matching_option?(how, what)
190
+ selected_options.each do |opt|
191
+ value = opt.send(how)
192
+ if what.is_a?(String) ? value == what : value =~ what
193
+ return true if opt.enabled?
194
+ raise Watir::Exception::ObjectDisabledException, "option matching #{what} by #{how} on #{inspect} is disabled"
195
+ end
196
+ end
197
+ false
198
+ end
199
+
200
+ def select_all_by(str_or_rx)
201
+ raise Error, "you can only use #select_all on multi-selects" unless multiple?
202
+ found = find_options :text, str_or_rx
203
+
204
+ return select_matching(found) if found
205
+ raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
206
+ end
207
+
208
+ def find_options(how, str_or_rx)
209
+ browser.wait_while do
210
+ case str_or_rx
211
+ when String, Numeric, Regexp
212
+ @found = how == :value ? options(value: str_or_rx) : []
213
+ @found = options(text: str_or_rx) if @found.empty?
214
+ @found = options(label: str_or_rx) if @found.empty?
215
+ @found.empty? && Watir.relaxed_locate?
216
+ else
217
+ raise TypeError, "expected String or Regexp, got #{str_or_rx.inspect}:#{str_or_rx.class}"
218
+ end
219
+ end
220
+ return @found unless @found.empty?
221
+ raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
222
+ rescue Wait::TimeoutError
223
+ raise NoValueFoundException, "#{str_or_rx.inspect} not found in select list"
224
+ end
225
+
226
+ def select_matching(elements)
227
+ elements = [elements.first] unless multiple?
228
+ elements.each { |e| e.click unless e.selected? }
229
+ elements.first.exist? ? elements.first.text : ''
230
+ end
231
+
232
+ def matches_regexp?(how, element, exp)
233
+ case how
234
+ when :text
235
+ element.text =~ exp || element.label =~ exp
236
+ when :value
237
+ element.value =~ exp
238
+ else
239
+ raise Error, "unknown how: #{how.inspect}"
240
+ end
241
+ end
242
+ end # Select
243
+
244
+ module Container
245
+ alias_method :select_list, :select
246
+ alias_method :select_lists, :selects
247
+
248
+ Watir.tag_to_class[:select_list] = Select
249
+ end # Container
250
+ end # Watir