watir 7.0.0 → 7.2.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (258) hide show
  1. checksums.yaml +4 -4
  2. data/.github/workflows/chrome.yml +29 -16
  3. data/.github/workflows/edge.yml +19 -11
  4. data/.github/workflows/firefox.yml +28 -16
  5. data/.github/workflows/ie.yml +13 -7
  6. data/.github/workflows/safari.yml +22 -11
  7. data/.github/workflows/unit.yml +31 -23
  8. data/.rubocop.yml +33 -13
  9. data/.rubocop_todo.yml +7 -26
  10. data/CHANGES.md +33 -0
  11. data/Gemfile +6 -1
  12. data/LICENSE +2 -2
  13. data/README.md +15 -11
  14. data/Rakefile +9 -7
  15. data/lib/watir/adjacent.rb +3 -1
  16. data/lib/watir/after_hooks.rb +5 -3
  17. data/lib/watir/alert.rb +2 -0
  18. data/lib/watir/aliases.rb +2 -0
  19. data/lib/watir/attribute_helper.rb +4 -2
  20. data/lib/watir/browser.rb +10 -14
  21. data/lib/watir/capabilities.rb +53 -33
  22. data/lib/watir/cell_container.rb +2 -0
  23. data/lib/watir/container.rb +2 -0
  24. data/lib/watir/cookies.rb +5 -5
  25. data/lib/watir/element_collection.rb +3 -1
  26. data/lib/watir/elements/button.rb +2 -0
  27. data/lib/watir/elements/cell.rb +2 -0
  28. data/lib/watir/elements/checkbox.rb +2 -0
  29. data/lib/watir/elements/date_field.rb +2 -0
  30. data/lib/watir/elements/date_time_field.rb +2 -0
  31. data/lib/watir/elements/dlist.rb +3 -1
  32. data/lib/watir/elements/element.rb +68 -118
  33. data/lib/watir/elements/file_field.rb +2 -0
  34. data/lib/watir/elements/font.rb +2 -0
  35. data/lib/watir/elements/form.rb +2 -0
  36. data/lib/watir/elements/hidden.rb +2 -0
  37. data/lib/watir/elements/iframe.rb +2 -0
  38. data/lib/watir/elements/image.rb +2 -0
  39. data/lib/watir/elements/input.rb +2 -0
  40. data/lib/watir/elements/link.rb +2 -0
  41. data/lib/watir/elements/list.rb +2 -0
  42. data/lib/watir/elements/option.rb +2 -0
  43. data/lib/watir/elements/radio.rb +2 -0
  44. data/lib/watir/elements/row.rb +2 -0
  45. data/lib/watir/elements/select.rb +2 -0
  46. data/lib/watir/elements/table.rb +3 -1
  47. data/lib/watir/elements/table_cell.rb +2 -0
  48. data/lib/watir/elements/table_row.rb +2 -0
  49. data/lib/watir/elements/table_section.rb +2 -0
  50. data/lib/watir/elements/text_area.rb +2 -0
  51. data/lib/watir/elements/text_field.rb +2 -0
  52. data/lib/watir/exception.rb +2 -0
  53. data/lib/watir/extensions/nokogiri.rb +2 -0
  54. data/lib/watir/generator/base/generator.rb +2 -0
  55. data/lib/watir/generator/base/idl_sorter.rb +3 -1
  56. data/lib/watir/generator/base/spec_extractor.rb +6 -4
  57. data/lib/watir/generator/base/util.rb +2 -0
  58. data/lib/watir/generator/base/visitor.rb +5 -5
  59. data/lib/watir/generator/base.rb +2 -1
  60. data/lib/watir/generator/html/generator.rb +2 -0
  61. data/lib/watir/generator/html/spec_extractor.rb +2 -0
  62. data/lib/watir/generator/html/visitor.rb +2 -0
  63. data/lib/watir/generator/html.rb +2 -0
  64. data/lib/watir/generator/svg/generator.rb +2 -0
  65. data/lib/watir/generator/svg/spec_extractor.rb +2 -0
  66. data/lib/watir/generator/svg/visitor.rb +2 -0
  67. data/lib/watir/generator/svg.rb +2 -0
  68. data/lib/watir/generator.rb +2 -0
  69. data/lib/watir/has_window.rb +3 -1
  70. data/lib/watir/http_client.rb +2 -0
  71. data/lib/watir/js_execution.rb +2 -0
  72. data/lib/watir/js_snippets/isElementInViewport.js +20 -0
  73. data/lib/watir/js_snippets.rb +2 -0
  74. data/lib/watir/locators/anchor/selector_builder.rb +5 -0
  75. data/lib/watir/locators/button/matcher.rb +2 -0
  76. data/lib/watir/locators/button/selector_builder/xpath.rb +15 -19
  77. data/lib/watir/locators/button/selector_builder.rb +2 -0
  78. data/lib/watir/locators/cell/selector_builder/xpath.rb +2 -0
  79. data/lib/watir/locators/cell/selector_builder.rb +2 -0
  80. data/lib/watir/locators/element/locator.rb +2 -0
  81. data/lib/watir/locators/element/matcher.rb +4 -1
  82. data/lib/watir/locators/element/selector_builder/regexp_disassembler.rb +4 -1
  83. data/lib/watir/locators/element/selector_builder/xpath.rb +16 -15
  84. data/lib/watir/locators/element/selector_builder/xpath_support.rb +4 -2
  85. data/lib/watir/locators/element/selector_builder.rb +16 -6
  86. data/lib/watir/locators/option/matcher.rb +2 -0
  87. data/lib/watir/locators/option/selector_builder/xpath.rb +2 -0
  88. data/lib/watir/locators/option/selector_builder.rb +2 -0
  89. data/lib/watir/locators/row/selector_builder/xpath.rb +2 -0
  90. data/lib/watir/locators/row/selector_builder.rb +2 -0
  91. data/lib/watir/locators/text_area/selector_builder/xpath.rb +2 -0
  92. data/lib/watir/locators/text_area/selector_builder.rb +2 -0
  93. data/lib/watir/locators/text_field/matcher.rb +2 -4
  94. data/lib/watir/locators/text_field/selector_builder/xpath.rb +2 -0
  95. data/lib/watir/locators/text_field/selector_builder.rb +2 -0
  96. data/lib/watir/locators.rb +2 -0
  97. data/lib/watir/logger.rb +2 -0
  98. data/lib/watir/navigation.rb +3 -1
  99. data/lib/watir/radio_set.rb +2 -0
  100. data/lib/watir/row_container.rb +2 -0
  101. data/lib/watir/screenshot.rb +2 -0
  102. data/lib/watir/scroll.rb +29 -3
  103. data/lib/watir/search_context.rb +96 -0
  104. data/lib/watir/shadow_root.rb +60 -0
  105. data/lib/watir/user_editable.rb +3 -1
  106. data/lib/watir/version.rb +3 -1
  107. data/lib/watir/wait/timer.rb +3 -1
  108. data/lib/watir/wait.rb +5 -5
  109. data/lib/watir/window.rb +7 -3
  110. data/lib/watir/window_collection.rb +4 -1
  111. data/lib/watir.rb +4 -0
  112. data/lib/watirspec/guards.rb +2 -0
  113. data/lib/watirspec/implementation.rb +14 -10
  114. data/lib/watirspec/rake_tasks.rb +4 -4
  115. data/lib/watirspec/remote_server.rb +5 -3
  116. data/lib/watirspec/runner.rb +3 -1
  117. data/lib/watirspec/server/app.rb +2 -0
  118. data/lib/watirspec/server.rb +2 -0
  119. data/lib/watirspec.rb +7 -4
  120. data/spec/locator_spec_helper.rb +2 -8
  121. data/spec/spec_helper.rb +2 -0
  122. data/spec/unit/capabilities_spec.rb +561 -550
  123. data/spec/unit/element_locator_spec.rb +71 -58
  124. data/spec/unit/match_elements/button_spec.rb +58 -49
  125. data/spec/unit/match_elements/element_spec.rb +305 -309
  126. data/spec/unit/match_elements/text_field_spec.rb +78 -73
  127. data/spec/unit/selector_builder/anchor_spec.rb +41 -33
  128. data/spec/unit/selector_builder/button_spec.rb +211 -201
  129. data/spec/unit/selector_builder/cell_spec.rb +50 -42
  130. data/spec/unit/selector_builder/element_spec.rb +636 -628
  131. data/spec/unit/selector_builder/row_spec.rb +121 -104
  132. data/spec/unit/selector_builder/text_field_spec.rb +197 -182
  133. data/spec/unit/selector_builder/textarea_spec.rb +24 -14
  134. data/spec/unit/unit_helper.rb +2 -0
  135. data/spec/unit/wait_spec.rb +77 -71
  136. data/spec/watirspec/adjacent_spec.rb +251 -247
  137. data/spec/watirspec/after_hooks_spec.rb +160 -162
  138. data/spec/watirspec/alert_spec.rb +63 -58
  139. data/spec/watirspec/browser_spec.rb +411 -407
  140. data/spec/watirspec/capabilities_spec.rb +566 -0
  141. data/spec/watirspec/cookies_spec.rb +122 -118
  142. data/spec/watirspec/drag_and_drop_spec.rb +30 -14
  143. data/spec/watirspec/element_hidden_spec.rb +68 -60
  144. data/spec/watirspec/elements/area_spec.rb +51 -47
  145. data/spec/watirspec/elements/areas_spec.rb +29 -25
  146. data/spec/watirspec/elements/button_spec.rb +255 -251
  147. data/spec/watirspec/elements/buttons_spec.rb +38 -34
  148. data/spec/watirspec/elements/checkbox_spec.rb +50 -36
  149. data/spec/watirspec/elements/checkboxes_spec.rb +31 -27
  150. data/spec/watirspec/elements/collections_spec.rb +128 -119
  151. data/spec/watirspec/elements/date_field_spec.rb +187 -183
  152. data/spec/watirspec/elements/date_fields_spec.rb +31 -27
  153. data/spec/watirspec/elements/date_time_field_spec.rb +199 -195
  154. data/spec/watirspec/elements/date_time_fields_spec.rb +32 -28
  155. data/spec/watirspec/elements/dd_spec.rb +89 -85
  156. data/spec/watirspec/elements/dds_spec.rb +29 -25
  157. data/spec/watirspec/elements/del_spec.rb +108 -104
  158. data/spec/watirspec/elements/dels_spec.rb +28 -24
  159. data/spec/watirspec/elements/div_spec.rb +227 -211
  160. data/spec/watirspec/elements/divs_spec.rb +39 -35
  161. data/spec/watirspec/elements/dl_spec.rb +112 -110
  162. data/spec/watirspec/elements/dls_spec.rb +30 -26
  163. data/spec/watirspec/elements/dt_spec.rb +88 -84
  164. data/spec/watirspec/elements/dts_spec.rb +29 -25
  165. data/spec/watirspec/elements/element_spec.rb +815 -715
  166. data/spec/watirspec/elements/elements_spec.rb +42 -38
  167. data/spec/watirspec/elements/em_spec.rb +64 -60
  168. data/spec/watirspec/elements/ems_spec.rb +30 -26
  169. data/spec/watirspec/elements/filefield_spec.rb +100 -96
  170. data/spec/watirspec/elements/filefields_spec.rb +30 -26
  171. data/spec/watirspec/elements/font_spec.rb +22 -18
  172. data/spec/watirspec/elements/form_spec.rb +53 -49
  173. data/spec/watirspec/elements/forms_spec.rb +31 -27
  174. data/spec/watirspec/elements/frame_spec.rb +91 -87
  175. data/spec/watirspec/elements/frames_spec.rb +29 -25
  176. data/spec/watirspec/elements/hidden_spec.rb +81 -77
  177. data/spec/watirspec/elements/hiddens_spec.rb +30 -26
  178. data/spec/watirspec/elements/hn_spec.rb +61 -57
  179. data/spec/watirspec/elements/hns_spec.rb +28 -24
  180. data/spec/watirspec/elements/iframe_spec.rb +197 -191
  181. data/spec/watirspec/elements/iframes_spec.rb +33 -29
  182. data/spec/watirspec/elements/image_spec.rb +146 -142
  183. data/spec/watirspec/elements/images_spec.rb +28 -24
  184. data/spec/watirspec/elements/input_spec.rb +11 -7
  185. data/spec/watirspec/elements/ins_spec.rb +108 -104
  186. data/spec/watirspec/elements/inses_spec.rb +28 -24
  187. data/spec/watirspec/elements/label_spec.rb +58 -54
  188. data/spec/watirspec/elements/labels_spec.rb +28 -24
  189. data/spec/watirspec/elements/li_spec.rb +76 -72
  190. data/spec/watirspec/elements/link_spec.rb +175 -179
  191. data/spec/watirspec/elements/links_spec.rb +47 -43
  192. data/spec/watirspec/elements/lis_spec.rb +29 -25
  193. data/spec/watirspec/elements/list_spec.rb +46 -42
  194. data/spec/watirspec/elements/map_spec.rb +59 -55
  195. data/spec/watirspec/elements/maps_spec.rb +29 -25
  196. data/spec/watirspec/elements/meta_spec.rb +18 -14
  197. data/spec/watirspec/elements/metas_spec.rb +28 -24
  198. data/spec/watirspec/elements/ol_spec.rb +58 -65
  199. data/spec/watirspec/elements/ols_spec.rb +28 -24
  200. data/spec/watirspec/elements/option_spec.rb +93 -89
  201. data/spec/watirspec/elements/p_spec.rb +79 -75
  202. data/spec/watirspec/elements/pre_spec.rb +77 -73
  203. data/spec/watirspec/elements/pres_spec.rb +28 -24
  204. data/spec/watirspec/elements/ps_spec.rb +28 -24
  205. data/spec/watirspec/elements/radio_spec.rb +253 -249
  206. data/spec/watirspec/elements/radios_spec.rb +30 -26
  207. data/spec/watirspec/elements/select_list_spec.rb +539 -522
  208. data/spec/watirspec/elements/select_lists_spec.rb +34 -30
  209. data/spec/watirspec/elements/span_spec.rb +114 -110
  210. data/spec/watirspec/elements/spans_spec.rb +28 -24
  211. data/spec/watirspec/elements/strong_spec.rb +60 -58
  212. data/spec/watirspec/elements/strongs_spec.rb +30 -26
  213. data/spec/watirspec/elements/table_spec.rb +194 -139
  214. data/spec/watirspec/elements/tables_spec.rb +30 -26
  215. data/spec/watirspec/elements/tbody_spec.rb +71 -67
  216. data/spec/watirspec/elements/tbodys_spec.rb +42 -38
  217. data/spec/watirspec/elements/td_spec.rb +68 -64
  218. data/spec/watirspec/elements/tds_spec.rb +43 -39
  219. data/spec/watirspec/elements/text_field_spec.rb +208 -204
  220. data/spec/watirspec/elements/text_fields_spec.rb +32 -28
  221. data/spec/watirspec/elements/textarea_spec.rb +22 -18
  222. data/spec/watirspec/elements/textareas_spec.rb +20 -16
  223. data/spec/watirspec/elements/tfoot_spec.rb +67 -63
  224. data/spec/watirspec/elements/tfoots_spec.rb +44 -40
  225. data/spec/watirspec/elements/thead_spec.rb +67 -63
  226. data/spec/watirspec/elements/theads_spec.rb +44 -40
  227. data/spec/watirspec/elements/tr_spec.rb +50 -46
  228. data/spec/watirspec/elements/trs_spec.rb +44 -40
  229. data/spec/watirspec/elements/ul_spec.rb +58 -54
  230. data/spec/watirspec/elements/uls_spec.rb +28 -24
  231. data/spec/watirspec/html/child_frame.html +29 -0
  232. data/spec/watirspec/html/class_locator.html +2 -0
  233. data/spec/watirspec/html/scroll.html +8 -25
  234. data/spec/watirspec/html/scroll_nested.html +17 -0
  235. data/spec/watirspec/html/scroll_nested_offscreen.html +18 -0
  236. data/spec/watirspec/html/shadow_dom.html +28 -0
  237. data/spec/watirspec/html/sticky_elements.html +10 -0
  238. data/spec/watirspec/radio_set_spec.rb +271 -267
  239. data/spec/watirspec/screenshot_spec.rb +22 -18
  240. data/spec/watirspec/scroll_spec.rb +179 -77
  241. data/spec/watirspec/shadow_root_spec.rb +106 -0
  242. data/spec/watirspec/support/rspec_matchers.rb +35 -32
  243. data/spec/watirspec/user_editable_spec.rb +202 -198
  244. data/spec/watirspec/wait_spec.rb +291 -295
  245. data/spec/watirspec/window_switching_spec.rb +426 -428
  246. data/spec/watirspec_helper.rb +25 -42
  247. data/support/doctest_helper.rb +2 -0
  248. data/support/version_differ.rb +2 -0
  249. data/watir.gemspec +14 -10
  250. metadata +91 -240
  251. data/.github/actions/enable-safari/action.yml +0 -11
  252. data/.github/actions/install-chrome/action.yml +0 -12
  253. data/.github/actions/setup-linux/action.yml +0 -8
  254. data/lib/watir-webdriver.rb +0 -2
  255. data/spec/watirspec/attributes_spec.rb +0 -16
  256. data/spec/watirspec/elements/table_nesting_spec.rb +0 -49
  257. data/spec/watirspec/html/hover.html +0 -12
  258. data/spec/watirspec/special_chars_spec.rb +0 -21
@@ -1,40 +1,44 @@
1
+ # frozen_string_literal: true
2
+
1
3
  require 'watirspec_helper'
2
4
 
3
- describe 'Areas' do
4
- before :each do
5
- browser.goto(WatirSpec.url_for('images.html'))
6
- end
5
+ module Watir
6
+ describe AreaCollection do
7
+ before do
8
+ browser.goto(WatirSpec.url_for('images.html'))
9
+ end
7
10
 
8
- describe 'with selectors' do
9
- it 'returns the matching elements' do
10
- expect(browser.areas(alt: 'Tables').to_a).to eq [browser.area(alt: 'Tables')]
11
+ describe 'with selectors' do
12
+ it 'returns the matching elements' do
13
+ expect(browser.areas(alt: 'Tables').to_a).to eq [browser.area(alt: 'Tables')]
14
+ end
11
15
  end
12
- end
13
16
 
14
- describe '#length' do
15
- it 'returns the number of areas' do
16
- expect(browser.areas.length).to eq 3
17
+ describe '#length' do
18
+ it 'returns the number of areas' do
19
+ expect(browser.areas.length).to eq 3
20
+ end
17
21
  end
18
- end
19
22
 
20
- describe '#[]' do
21
- it 'returns the area at the given index' do
22
- expect(browser.areas[0].id).to eq('NCE')
23
+ describe '#[]' do
24
+ it 'returns the area at the given index' do
25
+ expect(browser.areas[0].id).to eq('NCE')
26
+ end
23
27
  end
24
- end
25
28
 
26
- describe '#each' do
27
- it 'iterates through areas correctly' do
28
- count = 0
29
+ describe '#each' do
30
+ it 'iterates through areas correctly' do
31
+ count = 0
29
32
 
30
- browser.areas.each_with_index do |a, index|
31
- expect(a.id).to eq browser.area(index: index).id
32
- expect(a.title).to eq browser.area(index: index).title
33
+ browser.areas.each_with_index do |a, index|
34
+ expect(a.id).to eq browser.area(index: index).id
35
+ expect(a.title).to eq browser.area(index: index).title
33
36
 
34
- count += 1
35
- end
37
+ count += 1
38
+ end
36
39
 
37
- expect(count).to be > 0
40
+ expect(count).to be > 0
41
+ end
38
42
  end
39
43
  end
40
44
  end
@@ -1,261 +1,265 @@
1
- require 'watirspec_helper'
2
-
3
- describe 'Button' do
4
- before :each do
5
- browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
6
- end
7
-
8
- # Exists method
9
- describe '#exists?' do
10
- it 'returns true if the button exists (tag = :input)' do
11
- expect(browser.button(id: 'new_user_submit')).to exist
12
- expect(browser.button(id: /new_user_submit/)).to exist
13
- expect(browser.button(name: 'new_user_reset')).to exist
14
- expect(browser.button(name: /new_user_reset/)).to exist
15
- expect(browser.button(value: 'Button')).to exist
16
- expect(browser.button(value: /Button/)).to exist
17
- expect(browser.button(src: 'images/button.png')).to exist
18
- expect(browser.button(src: /button\.png/)).to exist
19
- expect(browser.button(text: 'Button 2')).to exist
20
- expect(browser.button(text: /Button 2/)).to exist
21
- expect(browser.button(class: 'image')).to exist
22
- expect(browser.button(class: /image/)).to exist
23
- expect(browser.button(index: 0)).to exist
24
- expect(browser.button(xpath: "//input[@id='new_user_submit']")).to exist
25
- expect(browser.button(alt: 'Create a new user')).to exist
26
- expect(browser.button(alt: /Create a/)).to exist
27
- end
28
-
29
- it 'returns true if the button exists (tag = :button)' do
30
- expect(browser.button(name: 'new_user_button_2')).to exist
31
- expect(browser.button(name: /new_user_button_2/)).to exist
32
- expect(browser.button(value: 'button_2')).to exist
33
- expect(browser.button(value: /button_2/)).to exist
34
- expect(browser.button(text: 'Button 2')).to exist
35
- expect(browser.button(text: /Button 2/)).to exist
36
- expect(browser.button(value: 'Button 2')).to exist
37
- expect(browser.button(value: /Button 2/)).to exist
38
- expect(browser.button(value: 'Button 4 With Child Text')).to exist
39
- expect(browser.button(value: /Button 4 With Child Text/)).to exist
40
- end
41
-
42
- it 'returns the first button if given no args' do
43
- expect(browser.button).to exist
44
- end
45
-
46
- it 'returns true for element with upper case type' do
47
- expect(browser.button(id: 'new_user_button_preview')).to exist
48
- end
49
-
50
- it "returns false if the button doesn't exist" do
51
- expect(browser.button(id: 'no_such_id')).to_not exist
52
- expect(browser.button(id: /no_such_id/)).to_not exist
53
- expect(browser.button(name: 'no_such_name')).to_not exist
54
- expect(browser.button(name: /no_such_name/)).to_not exist
55
- expect(browser.button(value: 'no_such_value')).to_not exist
56
- expect(browser.button(value: /no_such_value/)).to_not exist
57
- expect(browser.button(src: 'no_such_src')).to_not exist
58
- expect(browser.button(src: /no_such_src/)).to_not exist
59
- expect(browser.button(text: 'no_such_text')).to_not exist
60
- expect(browser.button(text: /no_such_text/)).to_not exist
61
- expect(browser.button(class: 'no_such_class')).to_not exist
62
- expect(browser.button(class: /no_such_class/)).to_not exist
63
- expect(browser.button(index: 1337)).to_not exist
64
- expect(browser.button(xpath: "//input[@id='no_such_id']")).to_not exist
65
- end
66
-
67
- it 'checks the tag name and type attribute when locating by xpath' do
68
- expect(browser.button(xpath: "//input[@type='text']")).to_not exist
69
- expect(browser.button(xpath: "//input[@type='button']")).to exist
70
- end
71
-
72
- it 'matches the specific type when locating by type' do
73
- expect(browser.button(type: 'button').type).to eq 'button'
74
- expect(browser.button(type: 'reset').type).to eq 'reset'
75
- expect(browser.button(type: 'submit').type).to eq 'submit'
76
- expect(browser.button(type: 'image').type).to eq 'image'
77
- end
78
-
79
- it 'matches valid input types when type is boolean' do
80
- expect(browser.buttons(type: false).map(&:tag_name)).to all eq('button')
81
-
82
- input_buttons = browser.buttons(type: true).select { |e| e.tag_name == 'input' }
83
- expect(input_buttons.map(&:type).uniq).to match_array(Watir::Button::VALID_TYPES)
84
- end
85
-
86
- it "raises TypeError when 'what' argument is invalid" do
87
- expect { browser.button(id: 3.14).exists? }.to raise_error(TypeError)
88
- end
89
- end
90
-
91
- # Attribute methods
92
- describe '#id' do
93
- it 'returns the id if the button exists' do
94
- expect(browser.button(index: 0).id).to eq 'new_user_submit'
95
- expect(browser.button(index: 1).id).to eq 'new_user_reset'
96
- expect(browser.button(index: 2).id).to eq 'new_user_button'
97
- end
98
-
99
- it 'raises UnknownObjectException if button does not exist' do
100
- expect { browser.button(index: 1337).id }.to raise_unknown_object_exception
101
- end
102
- end
103
-
104
- describe '#name' do
105
- it 'returns the name if button exists' do
106
- expect(browser.button(index: 0).name).to eq 'new_user_submit'
107
- expect(browser.button(index: 1).name).to eq 'new_user_reset'
108
- expect(browser.button(index: 2).name).to eq 'new_user_button'
109
- end
110
-
111
- it 'raises UnknownObjectException if the button does not exist' do
112
- expect { browser.button(name: 'no_such_name').name }.to raise_unknown_object_exception
113
- end
114
- end
115
-
116
- describe '#src' do
117
- it 'returns the src attribute for the button image' do
118
- # varies between browsers
119
- expect(browser.button(name: 'new_user_image').src).to include('images/button.png')
120
- end
121
-
122
- it 'raises UnknownObjectException if the button does not exist' do
123
- expect { browser.button(name: 'no_such_name').src }.to raise_unknown_object_exception
124
- end
125
- end
126
-
127
- describe '#style' do
128
- it 'returns the style attribute if the button exists' do
129
- expect(browser.button(id: 'delete_user_submit').style).to include 'border: 4px solid red;'
130
- end
131
-
132
- it "returns an empty string if the element exists and the attribute doesn't exist" do
133
- expect(browser.button(id: 'new_user_submit').style).to eq ''
134
- end
135
-
136
- it 'raises UnknownObjectException if the button does not exist' do
137
- expect { browser.button(name: 'no_such_name').style }.to raise_unknown_object_exception
138
- end
139
- end
140
-
141
- describe '#title' do
142
- it 'returns the title of the button' do
143
- expect(browser.button(index: 0).title).to eq 'Submit the form'
144
- end
145
-
146
- it 'returns an empty string for button without title' do
147
- expect(browser.button(index: 1).title).to eq ''
148
- end
149
- end
150
-
151
- describe '#type' do
152
- it 'returns the type if button exists' do
153
- expect(browser.button(index: 0).type).to eq 'submit'
154
- expect(browser.button(index: 1).type).to eq 'reset'
155
- expect(browser.button(index: 2).type).to eq 'button'
156
- end
157
-
158
- it 'raises UnknownObjectException if button does not exist' do
159
- expect { browser.button(name: 'no_such_name').type }.to raise_unknown_object_exception
160
- end
161
- end
162
-
163
- describe '#value' do
164
- it 'returns the value if button exists' do
165
- expect(browser.button(index: 0).value).to eq 'Submit'
166
- expect(browser.button(index: 1).value).to eq 'Reset'
167
- expect(browser.button(index: 2).value).to eq 'Button'
168
- end
169
-
170
- it 'raises UnknownObjectException if button does not exist' do
171
- expect { browser.button(name: 'no_such_name').value }.to raise_unknown_object_exception
172
- end
173
- end
174
-
175
- describe '#text' do
176
- it 'returns the text of an input button' do
177
- expect(browser.button(index: 0).text).to eq 'Submit'
178
- expect(browser.button(index: 1).text).to eq 'Reset'
179
- expect(browser.button(index: 2).text).to eq 'Button'
180
- expect(browser.button(index: 3).text).to eq 'Preview'
181
- end
182
-
183
- it 'returns the text of a button element' do
184
- expect(browser.button(name: 'new_user_button_2').text).to eq 'Button 2'
185
- end
186
-
187
- it 'raises UnknownObjectException if the element does not exist' do
188
- expect { browser.button(id: 'no_such_id').text }.to raise_unknown_object_exception
189
- end
190
- end
191
-
192
- describe '#respond_to?' do
193
- it 'returns true for all attribute methods' do
194
- expect(browser.button(index: 0)).to respond_to(:class_name)
195
- expect(browser.button(index: 0)).to respond_to(:id)
196
- expect(browser.button(index: 0)).to respond_to(:name)
197
- expect(browser.button(index: 0)).to respond_to(:src)
198
- expect(browser.button(index: 0)).to respond_to(:style)
199
- expect(browser.button(index: 0)).to respond_to(:title)
200
- expect(browser.button(index: 0)).to respond_to(:type)
201
- expect(browser.button(index: 0)).to respond_to(:value)
202
- end
203
- end
204
-
205
- # Access methods
206
- describe '#enabled?' do
207
- it 'returns true if the button is enabled' do
208
- expect(browser.button(name: 'new_user_submit')).to be_enabled
209
- end
210
-
211
- it 'returns false if the button is disabled' do
212
- expect(browser.button(name: 'new_user_submit_disabled')).to_not be_enabled
213
- end
214
-
215
- it "raises UnknownObjectException if the button doesn't exist" do
216
- expect { browser.button(name: 'no_such_name').enabled? }.to raise_unknown_object_exception
217
- end
218
-
219
- it 'raises ObjectDisabledException if disabled button is clicked' do
220
- expect { browser.button(name: 'new_user_submit_disabled').click }.to raise_object_disabled_exception
221
- end
222
- end
223
-
224
- describe '#disabled?' do
225
- it 'returns false when button is enabled' do
226
- expect(browser.button(name: 'new_user_submit')).to_not be_disabled
227
- end
228
-
229
- it 'returns true when button is disabled' do
230
- expect(browser.button(name: 'new_user_submit_disabled')).to be_disabled
231
- end
1
+ # frozen_string_literal: true
232
2
 
233
- it 'raises UnknownObjectException if button does not exist' do
234
- expect { browser.button(name: 'no_such_name').disabled? }.to raise_unknown_object_exception
235
- end
236
- end
3
+ require 'watirspec_helper'
237
4
 
238
- # Manipulation methods
239
- describe '#click' do
240
- it 'clicks the button if it exists' do
5
+ module Watir
6
+ describe Button do
7
+ before do
241
8
  browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
242
- browser.button(id: 'delete_user_submit').click
243
- browser.wait_while(url: /forms_with_input_elements\.html$/)
244
- expect(browser.text).to include('Semantic table')
245
9
  end
246
10
 
247
- it 'fires events' do
248
- browser.button(id: 'new_user_button').click
249
- expect(browser.button(id: 'new_user_button').value).to eq 'new_value_set_by_onclick_event'
250
- end
11
+ # Exists method
12
+ describe '#exists?' do
13
+ it 'returns true if the button exists (tag = :input)' do
14
+ expect(browser.button(id: 'new_user_submit')).to exist
15
+ expect(browser.button(id: /new_user_submit/)).to exist
16
+ expect(browser.button(name: 'new_user_reset')).to exist
17
+ expect(browser.button(name: /new_user_reset/)).to exist
18
+ expect(browser.button(value: 'Button')).to exist
19
+ expect(browser.button(value: /Button/)).to exist
20
+ expect(browser.button(src: 'images/button.png')).to exist
21
+ expect(browser.button(src: /button\.png/)).to exist
22
+ expect(browser.button(text: 'Button 2')).to exist
23
+ expect(browser.button(text: /Button 2/)).to exist
24
+ expect(browser.button(class: 'image')).to exist
25
+ expect(browser.button(class: /image/)).to exist
26
+ expect(browser.button(index: 0)).to exist
27
+ expect(browser.button(xpath: "//input[@id='new_user_submit']")).to exist
28
+ expect(browser.button(alt: 'Create a new user')).to exist
29
+ expect(browser.button(alt: /Create a/)).to exist
30
+ end
31
+
32
+ it 'returns true if the button exists (tag = :button)' do
33
+ expect(browser.button(name: 'new_user_button_2')).to exist
34
+ expect(browser.button(name: /new_user_button_2/)).to exist
35
+ expect(browser.button(value: 'button_2')).to exist
36
+ expect(browser.button(value: /button_2/)).to exist
37
+ expect(browser.button(text: 'Button 2')).to exist
38
+ expect(browser.button(text: /Button 2/)).to exist
39
+ expect(browser.button(value: 'Button 2')).to exist
40
+ expect(browser.button(value: /Button 2/)).to exist
41
+ expect(browser.button(value: 'Button 4 With Child Text')).to exist
42
+ expect(browser.button(value: /Button 4 With Child Text/)).to exist
43
+ end
44
+
45
+ it 'returns the first button if given no args' do
46
+ expect(browser.button).to exist
47
+ end
48
+
49
+ it 'returns true for element with upper case type' do
50
+ expect(browser.button(id: 'new_user_button_preview')).to exist
51
+ end
52
+
53
+ it "returns false if the button doesn't exist" do
54
+ expect(browser.button(id: 'no_such_id')).not_to exist
55
+ expect(browser.button(id: /no_such_id/)).not_to exist
56
+ expect(browser.button(name: 'no_such_name')).not_to exist
57
+ expect(browser.button(name: /no_such_name/)).not_to exist
58
+ expect(browser.button(value: 'no_such_value')).not_to exist
59
+ expect(browser.button(value: /no_such_value/)).not_to exist
60
+ expect(browser.button(src: 'no_such_src')).not_to exist
61
+ expect(browser.button(src: /no_such_src/)).not_to exist
62
+ expect(browser.button(text: 'no_such_text')).not_to exist
63
+ expect(browser.button(text: /no_such_text/)).not_to exist
64
+ expect(browser.button(class: 'no_such_class')).not_to exist
65
+ expect(browser.button(class: /no_such_class/)).not_to exist
66
+ expect(browser.button(index: 1337)).not_to exist
67
+ expect(browser.button(xpath: "//input[@id='no_such_id']")).not_to exist
68
+ end
69
+
70
+ it 'checks the tag name and type attribute when locating by xpath' do
71
+ expect(browser.button(xpath: "//input[@type='text']")).not_to exist
72
+ expect(browser.button(xpath: "//input[@type='button']")).to exist
73
+ end
74
+
75
+ it 'matches the specific type when locating by type' do
76
+ expect(browser.button(type: 'button').type).to eq 'button'
77
+ expect(browser.button(type: 'reset').type).to eq 'reset'
78
+ expect(browser.button(type: 'submit').type).to eq 'submit'
79
+ expect(browser.button(type: 'image').type).to eq 'image'
80
+ end
81
+
82
+ it 'matches valid input types when type is boolean' do
83
+ expect(browser.buttons(type: false).map(&:tag_name)).to all eq('button')
84
+
85
+ input_buttons = browser.buttons(type: true).select { |e| e.tag_name == 'input' }
86
+ expect(input_buttons.map(&:type).uniq).to match_array(Button::VALID_TYPES)
87
+ end
88
+
89
+ it "raises TypeError when 'what' argument is invalid" do
90
+ expect { browser.button(id: 3.14).exists? }.to raise_error(TypeError)
91
+ end
92
+ end
93
+
94
+ # Attribute methods
95
+ describe '#id' do
96
+ it 'returns the id if the button exists' do
97
+ expect(browser.button(index: 0).id).to eq 'new_user_submit'
98
+ expect(browser.button(index: 1).id).to eq 'new_user_reset'
99
+ expect(browser.button(index: 2).id).to eq 'new_user_button'
100
+ end
101
+
102
+ it 'raises UnknownObjectException if button does not exist' do
103
+ expect { browser.button(index: 1337).id }.to raise_unknown_object_exception
104
+ end
105
+ end
106
+
107
+ describe '#name' do
108
+ it 'returns the name if button exists' do
109
+ expect(browser.button(index: 0).name).to eq 'new_user_submit'
110
+ expect(browser.button(index: 1).name).to eq 'new_user_reset'
111
+ expect(browser.button(index: 2).name).to eq 'new_user_button'
112
+ end
113
+
114
+ it 'raises UnknownObjectException if the button does not exist' do
115
+ expect { browser.button(name: 'no_such_name').name }.to raise_unknown_object_exception
116
+ end
117
+ end
118
+
119
+ describe '#src' do
120
+ it 'returns the src attribute for the button image' do
121
+ # varies between browsers
122
+ expect(browser.button(name: 'new_user_image').src).to include('images/button.png')
123
+ end
124
+
125
+ it 'raises UnknownObjectException if the button does not exist' do
126
+ expect { browser.button(name: 'no_such_name').src }.to raise_unknown_object_exception
127
+ end
128
+ end
129
+
130
+ describe '#style' do
131
+ it 'returns the style attribute if the button exists' do
132
+ expect(browser.button(id: 'delete_user_submit').style).to include 'border: 4px solid red;'
133
+ end
134
+
135
+ it "returns an empty string if the element exists and the attribute doesn't exist" do
136
+ expect(browser.button(id: 'new_user_submit').style).to eq ''
137
+ end
138
+
139
+ it 'raises UnknownObjectException if the button does not exist' do
140
+ expect { browser.button(name: 'no_such_name').style }.to raise_unknown_object_exception
141
+ end
142
+ end
143
+
144
+ describe '#title' do
145
+ it 'returns the title of the button' do
146
+ expect(browser.button(index: 0).title).to eq 'Submit the form'
147
+ end
148
+
149
+ it 'returns an empty string for button without title' do
150
+ expect(browser.button(index: 1).title).to eq ''
151
+ end
152
+ end
153
+
154
+ describe '#type' do
155
+ it 'returns the type if button exists' do
156
+ expect(browser.button(index: 0).type).to eq 'submit'
157
+ expect(browser.button(index: 1).type).to eq 'reset'
158
+ expect(browser.button(index: 2).type).to eq 'button'
159
+ end
160
+
161
+ it 'raises UnknownObjectException if button does not exist' do
162
+ expect { browser.button(name: 'no_such_name').type }.to raise_unknown_object_exception
163
+ end
164
+ end
165
+
166
+ describe '#value' do
167
+ it 'returns the value if button exists' do
168
+ expect(browser.button(index: 0).value).to eq 'Submit'
169
+ expect(browser.button(index: 1).value).to eq 'Reset'
170
+ expect(browser.button(index: 2).value).to eq 'Button'
171
+ end
172
+
173
+ it 'raises UnknownObjectException if button does not exist' do
174
+ expect { browser.button(name: 'no_such_name').value }.to raise_unknown_object_exception
175
+ end
176
+ end
177
+
178
+ describe '#text' do
179
+ it 'returns the text of an input button' do
180
+ expect(browser.button(index: 0).text).to eq 'Submit'
181
+ expect(browser.button(index: 1).text).to eq 'Reset'
182
+ expect(browser.button(index: 2).text).to eq 'Button'
183
+ expect(browser.button(index: 3).text).to eq 'Preview'
184
+ end
185
+
186
+ it 'returns the text of a button element' do
187
+ expect(browser.button(name: 'new_user_button_2').text).to eq 'Button 2'
188
+ end
189
+
190
+ it 'raises UnknownObjectException if the element does not exist' do
191
+ expect { browser.button(id: 'no_such_id').text }.to raise_unknown_object_exception
192
+ end
193
+ end
194
+
195
+ describe '#respond_to?' do
196
+ it 'returns true for all attribute methods' do
197
+ expect(browser.button(index: 0)).to respond_to(:class_name)
198
+ expect(browser.button(index: 0)).to respond_to(:id)
199
+ expect(browser.button(index: 0)).to respond_to(:name)
200
+ expect(browser.button(index: 0)).to respond_to(:src)
201
+ expect(browser.button(index: 0)).to respond_to(:style)
202
+ expect(browser.button(index: 0)).to respond_to(:title)
203
+ expect(browser.button(index: 0)).to respond_to(:type)
204
+ expect(browser.button(index: 0)).to respond_to(:value)
205
+ end
206
+ end
207
+
208
+ # Access methods
209
+ describe '#enabled?' do
210
+ it 'returns true if the button is enabled' do
211
+ expect(browser.button(name: 'new_user_submit')).to be_enabled
212
+ end
251
213
 
252
- it "raises UnknownObjectException when clicking a button that doesn't exist" do
253
- expect { browser.button(value: 'no_such_value').click }.to raise_unknown_object_exception
254
- expect { browser.button(id: 'no_such_id').click }.to raise_unknown_object_exception
255
- end
214
+ it 'returns false if the button is disabled' do
215
+ expect(browser.button(name: 'new_user_submit_disabled')).not_to be_enabled
216
+ end
256
217
 
257
- it 'raises ObjectDisabledException when clicking a disabled button' do
258
- expect { browser.button(value: 'Disabled').click }.to raise_object_disabled_exception
218
+ it "raises UnknownObjectException if the button doesn't exist" do
219
+ expect { browser.button(name: 'no_such_name').enabled? }.to raise_unknown_object_exception
220
+ end
221
+
222
+ it 'raises ObjectDisabledException if disabled button is clicked' do
223
+ expect { browser.button(name: 'new_user_submit_disabled').click }.to raise_object_disabled_exception
224
+ end
225
+ end
226
+
227
+ describe '#disabled?' do
228
+ it 'returns false when button is enabled' do
229
+ expect(browser.button(name: 'new_user_submit')).not_to be_disabled
230
+ end
231
+
232
+ it 'returns true when button is disabled' do
233
+ expect(browser.button(name: 'new_user_submit_disabled')).to be_disabled
234
+ end
235
+
236
+ it 'raises UnknownObjectException if button does not exist' do
237
+ expect { browser.button(name: 'no_such_name').disabled? }.to raise_unknown_object_exception
238
+ end
239
+ end
240
+
241
+ # Manipulation methods
242
+ describe '#click' do
243
+ it 'clicks the button if it exists' do
244
+ browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
245
+ browser.button(id: 'delete_user_submit').click
246
+ browser.wait_while(url: /forms_with_input_elements\.html$/)
247
+ expect(browser.text).to include('Semantic table')
248
+ end
249
+
250
+ it 'fires events' do
251
+ browser.button(id: 'new_user_button').click
252
+ expect(browser.button(id: 'new_user_button').value).to eq 'new_value_set_by_onclick_event'
253
+ end
254
+
255
+ it "raises UnknownObjectException when clicking a button that doesn't exist" do
256
+ expect { browser.button(value: 'no_such_value').click }.to raise_unknown_object_exception
257
+ expect { browser.button(id: 'no_such_id').click }.to raise_unknown_object_exception
258
+ end
259
+
260
+ it 'raises ObjectDisabledException when clicking a disabled button' do
261
+ expect { browser.button(value: 'Disabled').click }.to raise_object_disabled_exception
262
+ end
259
263
  end
260
264
  end
261
265
  end
@@ -1,53 +1,57 @@
1
+ # frozen_string_literal: true
2
+
1
3
  require 'watirspec_helper'
2
4
 
3
- describe 'Buttons' do
4
- before :each do
5
- browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
6
- end
5
+ module Watir
6
+ describe ButtonCollection do
7
+ before do
8
+ browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
9
+ end
7
10
 
8
- describe 'with selectors' do
9
- it 'returns the matching elements' do
10
- expect(browser.buttons(name: 'new_user_button').to_a).to eq [browser.button(name: 'new_user_button')]
11
+ describe 'with selectors' do
12
+ it 'returns the matching elements' do
13
+ expect(browser.buttons(name: 'new_user_button').to_a).to eq [browser.button(name: 'new_user_button')]
14
+ end
11
15
  end
12
- end
13
16
 
14
- describe '#length' do
15
- it 'returns the number of buttons' do
16
- expect(browser.buttons.length).to eq 11
17
+ describe '#length' do
18
+ it 'returns the number of buttons' do
19
+ expect(browser.buttons.length).to eq 11
20
+ end
17
21
  end
18
- end
19
22
 
20
- describe '#[]' do
21
- it 'returns the button at the given index' do
22
- expect(browser.buttons[0].title).to eq 'Submit the form'
23
+ describe '#[]' do
24
+ it 'returns the button at the given index' do
25
+ expect(browser.buttons[0].title).to eq 'Submit the form'
26
+ end
23
27
  end
24
- end
25
28
 
26
- describe '#first' do
27
- it 'returns the first element in the collection' do
28
- expect(browser.buttons.first.value).to eq browser.buttons[0].value
29
+ describe '#first' do
30
+ it 'returns the first element in the collection' do
31
+ expect(browser.buttons.first.value).to eq browser.buttons[0].value
32
+ end
29
33
  end
30
- end
31
34
 
32
- describe '#last' do
33
- it 'returns the last element in the collection' do
34
- expect(browser.buttons.last.value).to eq browser.buttons[-1].value
35
+ describe '#last' do
36
+ it 'returns the last element in the collection' do
37
+ expect(browser.buttons.last.value).to eq browser.buttons[-1].value
38
+ end
35
39
  end
36
- end
37
40
 
38
- describe '#each' do
39
- it 'iterates through buttons correctly' do
40
- count = 0
41
+ describe '#each' do
42
+ it 'iterates through buttons correctly' do
43
+ count = 0
41
44
 
42
- browser.buttons.each_with_index do |b, index|
43
- expect(b.name).to eq browser.button(index: index).name
44
- expect(b.id).to eq browser.button(index: index).id
45
- expect(b.value).to eq browser.button(index: index).value
45
+ browser.buttons.each_with_index do |b, index|
46
+ expect(b.name).to eq browser.button(index: index).name
47
+ expect(b.id).to eq browser.button(index: index).id
48
+ expect(b.value).to eq browser.button(index: index).value
46
49
 
47
- count += 1
48
- end
50
+ count += 1
51
+ end
49
52
 
50
- expect(count).to be > 0
53
+ expect(count).to be > 0
54
+ end
51
55
  end
52
56
  end
53
57
  end