awetestlib 0.1.22-x86-mingw32 → 0.1.23-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/.yardopts +7 -0
- data/lib/awetestlib/html_report.rb +15 -44
- data/lib/awetestlib/logging.rb +334 -374
- data/lib/awetestlib/regression/browser.rb +61 -71
- data/lib/awetestlib/regression/drag_and_drop.rb +31 -5
- data/lib/awetestlib/regression/find.rb +21 -139
- data/lib/awetestlib/regression/legacy.rb +1175 -1
- data/lib/awetestlib/regression/runner.rb +10 -6
- data/lib/awetestlib/regression/tables.rb +71 -25
- data/lib/awetestlib/regression/user_input.rb +88 -900
- data/lib/awetestlib/regression/utilities.rb +43 -18
- data/lib/awetestlib/regression/validations.rb +165 -248
- data/lib/awetestlib/regression/waits.rb +180 -94
- data/lib/awetestlib/runner.rb +1 -0
- data/lib/awetestlib.rb +3 -1
- data/lib/version.rb +2 -2
- data/test/create_zoho_account1.rb +1 -1
- data/test/login.xls +0 -0
- data/test/login_1.rb +37 -0
- data/test/login_1a.rb +37 -0
- data/test/login_2.rb +32 -0
- data/test/zoho_exercise.rb +21 -0
- metadata +10 -4
|
@@ -2,16 +2,9 @@ module Awetestlib
|
|
|
2
2
|
# Awetest DSL for browser based testing.
|
|
3
3
|
module Regression
|
|
4
4
|
# Methods covering user interactions with the browser.
|
|
5
|
-
#
|
|
6
|
-
#
|
|
7
|
-
# All of the methods in groups other than Core call Core methods.
|
|
8
|
-
# The methods in the other groups, along with aliases, exist for backward compatibility with earlier versions
|
|
9
|
-
# of the Awetest DSL.
|
|
10
5
|
module UserInput
|
|
11
6
|
|
|
12
|
-
#
|
|
13
|
-
|
|
14
|
-
# Click a specific DOM element identified by one of its attributes and that attribute's value.
|
|
7
|
+
# Click a specific DOM element identified by one of its attributes (*how*) and that attribute's value (*what*).
|
|
15
8
|
#
|
|
16
9
|
# @example
|
|
17
10
|
# # html for a link element:
|
|
@@ -31,219 +24,40 @@ module Awetestlib
|
|
|
31
24
|
#
|
|
32
25
|
def click(browser, element, how, what, desc = '')
|
|
33
26
|
#debug_to_log("#{__method__}: #{element}, #{how}, #{what}")
|
|
34
|
-
msg = build_message("
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
else
|
|
58
|
-
browser.element(how, what).click
|
|
59
|
-
end
|
|
27
|
+
msg = build_message("#{__method__.to_s.humanize} :#{element} :#{how}=>'#{what}'", desc)
|
|
28
|
+
case element
|
|
29
|
+
when :link
|
|
30
|
+
browser.link(how, what).click
|
|
31
|
+
when :button
|
|
32
|
+
browser.button(how, what).click
|
|
33
|
+
when :image
|
|
34
|
+
browser.image(how, what).click
|
|
35
|
+
when :radio
|
|
36
|
+
case how
|
|
37
|
+
when :index
|
|
38
|
+
set_radio_by_index(browser, what, desc)
|
|
39
|
+
else
|
|
40
|
+
browser.radio(how, what).set
|
|
41
|
+
end
|
|
42
|
+
when :span
|
|
43
|
+
browser.span(how, what).click
|
|
44
|
+
when :div
|
|
45
|
+
browser.div(how, what).click
|
|
46
|
+
when :cell
|
|
47
|
+
browser.cell(how, what).click
|
|
48
|
+
else
|
|
49
|
+
browser.element(how, what).click
|
|
60
50
|
end
|
|
61
|
-
|
|
62
|
-
|
|
51
|
+
passed_to_log(msg)
|
|
52
|
+
true
|
|
63
53
|
rescue
|
|
64
54
|
failed_to_log("Unable to #{msg}. '#{$!}'")
|
|
65
55
|
end
|
|
66
56
|
|
|
67
|
-
#
|
|
68
|
-
|
|
69
|
-
# @!group Click
|
|
70
|
-
|
|
71
|
-
# Click a button element identified by the value of its *:id* attribute. A button is an HTML element with tag 'input' and type 'submit' or 'button'.
|
|
72
|
-
# @param [Watir::Browser, Watir::Container] browser A reference to the browser window or container element to be tested.
|
|
73
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
74
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
75
|
-
# @return (see #click)
|
|
76
|
-
def click_button_by_id(browser, what, desc = '')
|
|
77
|
-
click(browser, :button, :id, what, desc)
|
|
78
|
-
end
|
|
79
|
-
|
|
80
|
-
# Click a button element identified by the value of its index within the container referred to by <b>*browser*</b>.
|
|
81
|
-
# @param [Watir::Browser, Watir::Container] browser A reference to the browser window or container element to be tested.
|
|
82
|
-
# @param [Fixnum] what An integer that indicates the index of the element within the container.
|
|
83
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
84
|
-
# @return (see #click)
|
|
85
|
-
def click_link_by_index(browser, what, desc = '')
|
|
86
|
-
click(browser, :link, :index, what, desc)
|
|
87
|
-
end
|
|
88
|
-
|
|
89
|
-
# Click a link element identified by the value of its *:href* attribute. Take care to escape characters in the url that are reserved by Regexp.
|
|
90
|
-
# @param (see #click_button_by_id)
|
|
91
|
-
# @return (see #click)
|
|
92
|
-
def click_link_by_href(browser, what, desc = '')
|
|
93
|
-
click(browser, :link, :href, what, desc)
|
|
94
|
-
end
|
|
95
|
-
|
|
96
|
-
alias click_href click_link_by_href
|
|
97
|
-
|
|
98
|
-
# Click a link element identified by the value of its *:href* attribute and do not wait for the browser to reach ready state.
|
|
99
|
-
# Take care to escape characters in the url that are reserved by Regexp.
|
|
100
|
-
# @param (see #click_button_by_id)
|
|
101
|
-
# @return (see #click)
|
|
102
|
-
def click_link_no_wait_by_href(browser, what, desc = '')
|
|
103
|
-
click_no_wait(browser, :link, :href, what, desc)
|
|
104
|
-
end
|
|
105
|
-
|
|
106
|
-
# Click a button element identified by the value of its index within the container referred to by <b>*browser*</b>.
|
|
107
|
-
# @param (see #click_link_by_index)
|
|
108
|
-
# @return (see #click)
|
|
109
|
-
def click_button_by_index(browser, what, desc = '')
|
|
110
|
-
click(browser, :button, :index, what, desc)
|
|
111
|
-
end
|
|
112
|
-
|
|
113
|
-
# Click a button element identified by the value of its *:name* attribute. A button is an HTML element with tag 'input' and type 'submit' or 'button'.
|
|
114
|
-
# @param (see #click_button_by_id)
|
|
115
|
-
# @return (see #click)
|
|
116
|
-
def click_button_by_name(browser, what, desc = '')
|
|
117
|
-
click(browser, :button, :name, what, desc)
|
|
118
|
-
end
|
|
119
|
-
|
|
120
|
-
# Click a button element identified by the value of its *:text* attribute. A button is an HTML element with tag 'input' and type 'submit' or 'button'.
|
|
121
|
-
# @param (see #click_button_by_id)
|
|
122
|
-
# @return (see #click)
|
|
123
|
-
def click_button_by_text(browser, what, desc = '')
|
|
124
|
-
click(browser, :button, :text, what, desc)
|
|
125
|
-
end
|
|
126
|
-
|
|
127
|
-
# Click a button element identified by the value of its *:class* attribute. A button is an HTML element with tag 'input' and type 'submit' or 'button'.
|
|
128
|
-
# @param (see #click_button_by_id)
|
|
129
|
-
# @return (see #click)
|
|
130
|
-
def click_button_by_class(browser, what, desc = '')
|
|
131
|
-
click(browser, :button, :class, what, desc)
|
|
132
|
-
end
|
|
133
|
-
|
|
134
|
-
# Click a button element identified by the value of its *:value* attribute. A button is an HTML element with tag 'input' and type 'submit' or 'button'.
|
|
135
|
-
# @param (see #click_button_by_id)
|
|
136
|
-
# @return (see #click)
|
|
137
|
-
def click_button_by_value(browser, what, desc = '')
|
|
138
|
-
click(browser, :button, :value, what, desc)
|
|
139
|
-
end
|
|
140
|
-
|
|
141
|
-
# Click a button element identified by the value of its *:title* attribute. A button is an HTML element with tag 'input' and type 'submit' or 'button'.
|
|
142
|
-
# @param (see #click_button_by_id)
|
|
143
|
-
# @return (see #click)
|
|
144
|
-
def click_button_by_title(browser, what, desc = '')
|
|
145
|
-
click(browser, :button, :title, what, desc)
|
|
146
|
-
end
|
|
147
|
-
|
|
148
|
-
# Click a link element identified by the value of its *:id* attribute.
|
|
149
|
-
# @param (see #click_button_by_id)
|
|
150
|
-
# @return (see #click)
|
|
151
|
-
def click_link_by_id(browser, what, desc = '')
|
|
152
|
-
click(browser, :link, :id, what, desc)
|
|
153
|
-
end
|
|
154
|
-
|
|
155
|
-
alias click_id click_link_by_id
|
|
156
|
-
|
|
157
|
-
# Click a link element identified by the value of its *:name* attribute.
|
|
158
|
-
# @param (see #click_button_by_id)
|
|
159
|
-
# @return (see #click)
|
|
160
|
-
def click_link_by_name(browser, what, desc = '')
|
|
161
|
-
click(browser, :link, :name, what, desc)
|
|
162
|
-
end
|
|
163
|
-
|
|
164
|
-
alias click_name click_link_by_name
|
|
165
|
-
|
|
166
|
-
# Click a file_field element identified by the value of its *:id* attribute.
|
|
167
|
-
# @param (see #click_button_by_id)
|
|
168
|
-
# @return (see #click)
|
|
169
|
-
def click_file_field_by_id(browser, what, desc = '')
|
|
170
|
-
click(browser, :file_field, :id, what, desc)
|
|
171
|
-
end
|
|
172
|
-
|
|
173
|
-
# Click an image element identified by the value of its *:id* attribute.
|
|
174
|
-
# @param (see #click_button_by_id)
|
|
175
|
-
# @return (see #click)
|
|
176
|
-
def click_img_by_alt(browser, what, desc = '')
|
|
177
|
-
click(browser, :image, :alt, what, desc)
|
|
178
|
-
end
|
|
179
|
-
|
|
180
|
-
# Click an image element identified by the value of its *:title* attribute.
|
|
181
|
-
# @param (see #click_button_by_id)
|
|
182
|
-
# @return (see #click)
|
|
183
|
-
def click_img_by_title(browser, what, desc = '')
|
|
184
|
-
click(browser, :image, :title, what, desc)
|
|
185
|
-
end
|
|
186
|
-
|
|
187
|
-
# Click an image element identified by the value of its *:src* attribute.
|
|
188
|
-
# Take care to escape characters in the source url that are reserved by Regexp.
|
|
189
|
-
# @param (see #click_button_by_id)
|
|
190
|
-
# @return (see #click)
|
|
191
|
-
def click_img_by_src(browser, what, desc = '')
|
|
192
|
-
click(browser, :image, :src, what, desc)
|
|
193
|
-
end
|
|
194
|
-
|
|
195
|
-
# Click a link element identified by the value of its *:value* attribute.
|
|
196
|
-
# @param (see #click_button_by_id)
|
|
197
|
-
# @return (see #click)
|
|
198
|
-
def click_link_by_value(browser, what, desc = '')
|
|
199
|
-
click(browser, :link, :value, what, desc)
|
|
200
|
-
end
|
|
201
|
-
|
|
202
|
-
# Click a link element identified by the value in its text (innerHTML).
|
|
203
|
-
# @param (see #click_button_by_id)
|
|
204
|
-
# @return (see #click)
|
|
205
|
-
def click_link_by_text(browser, what, desc = '')
|
|
206
|
-
click(browser, :link, :text, what, desc)
|
|
207
|
-
end
|
|
208
|
-
|
|
209
|
-
alias click_link click_link_by_text
|
|
210
|
-
alias click_text click_link_by_text
|
|
211
|
-
alias click_js_button click_link_by_text
|
|
212
|
-
|
|
213
|
-
# Click a link element identified by the value of its *:class* attribute.
|
|
214
|
-
# @param (see #click_button_by_id)
|
|
215
|
-
# @return (see #click)
|
|
216
|
-
def click_link_by_class(browser, what, desc = '')
|
|
217
|
-
click(browser, :link, :class, what, desc)
|
|
218
|
-
end
|
|
219
|
-
|
|
220
|
-
alias click_class click_link_by_class
|
|
221
|
-
|
|
222
|
-
# Click a span element identified by the value in its text (innerHTML).
|
|
223
|
-
# @param (see #click_button_by_id)
|
|
224
|
-
# @return (see #click)
|
|
225
|
-
def click_span_by_text(browser, what, desc = '')
|
|
226
|
-
click(browser, :span, :text, what)
|
|
227
|
-
end
|
|
228
|
-
|
|
229
|
-
alias click_span_with_text click_span_by_text
|
|
230
|
-
|
|
231
|
-
# Click a link element identified by the value of its *:title* attribute.
|
|
232
|
-
# @param (see #click_button_by_id)
|
|
233
|
-
# @return (see #click)
|
|
234
|
-
def click_link_by_title(browser, what, desc = '')
|
|
235
|
-
click(browser, :link, :title, what, desc)
|
|
236
|
-
end
|
|
237
|
-
|
|
238
|
-
alias click_title click_link_by_title
|
|
239
|
-
|
|
240
|
-
# @!endgroup Click
|
|
241
|
-
|
|
242
|
-
# @!group Core
|
|
243
|
-
|
|
244
|
-
# Click a specific DOM element by one of its attributes and that attribute's value and
|
|
57
|
+
# Click a specific DOM element by one of its attributes (*how) and that attribute's value (*what) and
|
|
245
58
|
# do not wait for the browser to finish reloading. Used when a modal popup or alert is expected. Allows the script
|
|
246
59
|
# to keep running so the popup can be handled.
|
|
60
|
+
# @todo handle using Watir Webdriver which does not need no_wait.
|
|
247
61
|
#
|
|
248
62
|
# @example
|
|
249
63
|
# # html for a link element:
|
|
@@ -257,9 +71,7 @@ module Awetestlib
|
|
|
257
71
|
# @return (see #click)
|
|
258
72
|
#
|
|
259
73
|
def click_no_wait(browser, element, how, what, desc = '')
|
|
260
|
-
|
|
261
|
-
msg = build_message("Click no wait #{element} :#{how}=>'#{what}'", desc)
|
|
262
|
-
msg1 = "#{element}(#{how}, '#{what}'"
|
|
74
|
+
msg = build_message("#{__method__.to_s.humanize} :#{element} :#{how}=>'#{what}'", desc)
|
|
263
75
|
begin
|
|
264
76
|
case element
|
|
265
77
|
when :link
|
|
@@ -287,161 +99,17 @@ module Awetestlib
|
|
|
287
99
|
browser.element(how, what).click_no_wait
|
|
288
100
|
end
|
|
289
101
|
rescue => e
|
|
290
|
-
|
|
102
|
+
unless rescue_me(e, __method__, rescue_me_command(element, how, what, :click_no_wait), "#{browser.class}")
|
|
291
103
|
raise e
|
|
292
104
|
end
|
|
293
105
|
end
|
|
294
|
-
|
|
295
|
-
|
|
106
|
+
passed_to_log(msg)
|
|
107
|
+
true
|
|
296
108
|
rescue
|
|
297
109
|
failed_to_log("Unable to #{msg} '#{$!}'")
|
|
298
110
|
sleep_for(1)
|
|
299
111
|
end
|
|
300
112
|
|
|
301
|
-
# @!endgroup Core
|
|
302
|
-
|
|
303
|
-
alias click_href_no_wait click_link_no_wait_by_href
|
|
304
|
-
|
|
305
|
-
# @!group Click No Wait
|
|
306
|
-
|
|
307
|
-
# Click a button element identified by the value of its *:id* attribute
|
|
308
|
-
# and do not wait for the browser to reach ready state.
|
|
309
|
-
# @param (see #click_button_by_id)
|
|
310
|
-
# @return (see #click)
|
|
311
|
-
def click_button_no_wait_by_id(browser, what, desc = '')
|
|
312
|
-
click_no_wait(browser, :button, :id, what, desc)
|
|
313
|
-
end
|
|
314
|
-
|
|
315
|
-
alias click_button_by_id_no_wait click_button_no_wait_by_id
|
|
316
|
-
|
|
317
|
-
# Click a button element identified by the value of its *:name* attribute
|
|
318
|
-
# and do not wait for the browser to reach ready state.
|
|
319
|
-
# @param (see #click_button_by_id)
|
|
320
|
-
# @return (see #click)
|
|
321
|
-
def click_button_no_wait_by_name(browser, what, desc = '')
|
|
322
|
-
click_no_wait(browser, :button, :name, what, desc)
|
|
323
|
-
end
|
|
324
|
-
|
|
325
|
-
# Click a button element identified by the value of its *:class* attribute
|
|
326
|
-
# and do not wait for the browser to reach ready state.
|
|
327
|
-
# @param (see #click_button_by_id)
|
|
328
|
-
# @return (see #click)
|
|
329
|
-
def click_button_no_wait_by_class(browser, what, desc = '')
|
|
330
|
-
click_no_wait(browser, :button, :class, what, desc)
|
|
331
|
-
end
|
|
332
|
-
|
|
333
|
-
alias click_button_by_class_no_wait click_button_no_wait_by_class
|
|
334
|
-
|
|
335
|
-
# Click a link element identified by the value of its *:id* attribute
|
|
336
|
-
# and do not wait for the browser to reach ready state.
|
|
337
|
-
# @param (see #click_button_by_id)
|
|
338
|
-
# @return (see #click)
|
|
339
|
-
def click_link_no_wait_by_id(browser, what, desc = '')
|
|
340
|
-
click_no_wait(browser, :link, :id, what, desc)
|
|
341
|
-
end
|
|
342
|
-
|
|
343
|
-
alias click_no_wait_id click_link_no_wait_by_id
|
|
344
|
-
alias click_no_wait_by_id click_link_no_wait_by_id
|
|
345
|
-
alias click_id_no_wait click_link_no_wait_by_id
|
|
346
|
-
alias click_no_wait_link_by_id click_link_no_wait_by_id
|
|
347
|
-
|
|
348
|
-
# Click an image element identified by the value of its *:alt* attribute
|
|
349
|
-
# and do not wait for the browser to reach ready state.
|
|
350
|
-
# @param (see #click_button_by_id)
|
|
351
|
-
# @return (see #click)
|
|
352
|
-
def click_img_no_wait_by_alt(browser, what, desc = '')
|
|
353
|
-
click_no_wait(browser, :image, :alt, what, desc)
|
|
354
|
-
end
|
|
355
|
-
|
|
356
|
-
alias click_img_by_alt_no_wait click_img_no_wait_by_alt
|
|
357
|
-
|
|
358
|
-
# Click a button element identified by the value in its text (innerHTML)
|
|
359
|
-
# and do not wait for the browser to reach ready state.
|
|
360
|
-
# @param (see #click_button_by_id)
|
|
361
|
-
# @return (see #click)
|
|
362
|
-
def click_button_no_wait_by_text(browser, what, desc = '')
|
|
363
|
-
click_no_wait(browser, :button, :text, what, desc)
|
|
364
|
-
end
|
|
365
|
-
|
|
366
|
-
# Click a button element identified by the value of its *:value* attribute
|
|
367
|
-
# and do not wait for the browser to reach ready state.
|
|
368
|
-
# @param (see #click_button_by_id)
|
|
369
|
-
# @return (see #click)
|
|
370
|
-
def click_button_no_wait_by_value(browser, what, desc = '')
|
|
371
|
-
click_no_wait(browser, :button, :value, what, desc)
|
|
372
|
-
end
|
|
373
|
-
|
|
374
|
-
# Click a button element identified by the value of its *:name* attribute
|
|
375
|
-
# and do not wait for the browser to reach ready state.
|
|
376
|
-
# @param (see #click_button_by_id)
|
|
377
|
-
# @return (see #click)
|
|
378
|
-
def click_link_by_name_no_wait(browser, what, desc = '')
|
|
379
|
-
click_no_wait(browser, :link, :name, what, desc)
|
|
380
|
-
end
|
|
381
|
-
|
|
382
|
-
alias click_no_wait_name click_link_by_name_no_wait
|
|
383
|
-
alias click_name_no_wait click_link_by_name_no_wait
|
|
384
|
-
|
|
385
|
-
# Click a link element identified by the value in its text (innerHTML)
|
|
386
|
-
# and do not wait for the browser to reach ready state.
|
|
387
|
-
# @param (see #click_button_by_id)
|
|
388
|
-
# @return (see #click)
|
|
389
|
-
def click_link_by_text_no_wait(browser, what, desc = '')
|
|
390
|
-
click_no_wait(browser, :link, :text, what, desc)
|
|
391
|
-
end
|
|
392
|
-
|
|
393
|
-
alias click_no_wait_text click_link_by_text_no_wait
|
|
394
|
-
alias click_text_no_wait click_link_by_text_no_wait
|
|
395
|
-
|
|
396
|
-
# Click a link element identified by the value of its *:title* attribute
|
|
397
|
-
# and do not wait for the browser to reach ready state.
|
|
398
|
-
# @param (see #click_button_by_id)
|
|
399
|
-
# @return (see #click)
|
|
400
|
-
def click_title_no_wait(browser, what, desc = '')
|
|
401
|
-
click_no_wait(browser, :link, :title, what, desc)
|
|
402
|
-
end
|
|
403
|
-
|
|
404
|
-
# @!endgroup Click No Wait
|
|
405
|
-
|
|
406
|
-
# @!group Xpath
|
|
407
|
-
|
|
408
|
-
# Click a button element identified by the value of its *:id* attribute using the xpath functionality in Watir.
|
|
409
|
-
# A button is an HTML element with tag 'input' and type 'submit' or 'button'.
|
|
410
|
-
# @note Normally used only when the element is not located by other methods.
|
|
411
|
-
# @param (see #click_button_by_id)
|
|
412
|
-
# @return (see #click)
|
|
413
|
-
def click_button_by_xpath_and_id(browser, what, desc = '')
|
|
414
|
-
click(browser, :button, :xpath, "//a[@id = '#{what}']", desc)
|
|
415
|
-
end
|
|
416
|
-
|
|
417
|
-
alias click_button_by_xpath click_button_by_xpath_and_id
|
|
418
|
-
|
|
419
|
-
# Click a link element identified by the value of its *:id* attribute using the xpath functionality in Watir.
|
|
420
|
-
# @note Normally used only when the element is not located by other methods.
|
|
421
|
-
# @param (see #click_button_by_id)
|
|
422
|
-
# @return (see #click)
|
|
423
|
-
def click_link_by_xpath_and_id(browser, what, desc = '')
|
|
424
|
-
click(browser, :link, :xpath, "//a[@id = '#{what}']", desc)
|
|
425
|
-
end
|
|
426
|
-
|
|
427
|
-
alias click_link_by_xpath click_link_by_xpath_and_id
|
|
428
|
-
|
|
429
|
-
# Click an image element identified by the value of its *:name* attribute using the xpath functionality in Watir.
|
|
430
|
-
# @note Normally used only when the element is not located by other methods.
|
|
431
|
-
# @param (see #click_button_by_id)
|
|
432
|
-
# @return (see #click)
|
|
433
|
-
def click_img_by_xpath_and_name(browser, what, desc = '')
|
|
434
|
-
click(browser, :image, :xpath, "//a[@id = '#{what}']", desc)
|
|
435
|
-
end
|
|
436
|
-
|
|
437
|
-
alias click_img_by_xpath click_img_by_xpath_and_name
|
|
438
|
-
alias click_image_by_xpath click_img_by_xpath_and_name
|
|
439
|
-
alias click_image_by_xpath_and_name click_img_by_xpath_and_name
|
|
440
|
-
|
|
441
|
-
# @!endgroup Xpath
|
|
442
|
-
|
|
443
|
-
# @!group Core
|
|
444
|
-
|
|
445
113
|
# Click an image element identified by the value of its *:src* attribute and its index
|
|
446
114
|
# within the array of image elements with src containing <b>*what*</b> and
|
|
447
115
|
# within the container referred to by <b>*browser*</b>.
|
|
@@ -454,8 +122,8 @@ module Awetestlib
|
|
|
454
122
|
msg = "Click image by src='#{what}' and index=#{index}"
|
|
455
123
|
msg << " #{desc}" if desc.length > 0
|
|
456
124
|
browser.image(:src => what, :index => index).click
|
|
457
|
-
|
|
458
|
-
|
|
125
|
+
passed_to_log(msg)
|
|
126
|
+
true
|
|
459
127
|
rescue
|
|
460
128
|
failed_to_log("Unable to #{msg} '#{$!}'")
|
|
461
129
|
end
|
|
@@ -474,14 +142,14 @@ module Awetestlib
|
|
|
474
142
|
# @return (see #click)
|
|
475
143
|
#
|
|
476
144
|
def click_table_row_with_text(browser, how, what, text, desc = '', column = nil)
|
|
477
|
-
msg
|
|
145
|
+
msg = build_message("Click row with text #{text} in table :#{how}=>'#{what}.", desc)
|
|
478
146
|
table = get_table(browser, how, what, desc)
|
|
479
147
|
if table
|
|
480
148
|
index = get_index_of_row_with_text(table, text, column)
|
|
481
149
|
if index
|
|
482
150
|
table[index].click
|
|
483
|
-
|
|
484
|
-
|
|
151
|
+
passed_to_log(msg)
|
|
152
|
+
index
|
|
485
153
|
else
|
|
486
154
|
failed_to_log("#{msg} Row not found.")
|
|
487
155
|
end
|
|
@@ -499,14 +167,14 @@ module Awetestlib
|
|
|
499
167
|
# @return (see #click)
|
|
500
168
|
#
|
|
501
169
|
def double_click_table_row_with_text(browser, how, what, text, desc = '', column = nil)
|
|
502
|
-
msg
|
|
170
|
+
msg = build_message("Double click row with text #{text} in table :#{how}=>'#{what}.", desc)
|
|
503
171
|
table = get_table(browser, how, what, desc)
|
|
504
172
|
if table
|
|
505
173
|
index = get_index_of_row_with_text(table, text, column)
|
|
506
174
|
if index
|
|
507
175
|
table[index].fire_event('ondblclick')
|
|
508
|
-
|
|
509
|
-
|
|
176
|
+
passed_to_log(msg)
|
|
177
|
+
index
|
|
510
178
|
else
|
|
511
179
|
failed_to_log("#{msg} Row not found.")
|
|
512
180
|
end
|
|
@@ -517,59 +185,6 @@ module Awetestlib
|
|
|
517
185
|
failed_to_log("Unable to #{msg}: '#{$!}'")
|
|
518
186
|
end
|
|
519
187
|
|
|
520
|
-
# @!endgroup Core
|
|
521
|
-
|
|
522
|
-
# @!group Tables
|
|
523
|
-
|
|
524
|
-
# Click the first row which contains a particular string in a table identified by the value in its *:id* attribute.
|
|
525
|
-
#
|
|
526
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
527
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
|
|
528
|
-
# @param [String] text Full text string to be found in the table row.
|
|
529
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
530
|
-
# @param [Fixnum] column Integer indicating the column to search for the text string.
|
|
531
|
-
# If not supplied all columns will be checked.
|
|
532
|
-
# @return (see #click)
|
|
533
|
-
#
|
|
534
|
-
def click_table_row_with_text_by_id(browser, what, text, desc = '', column = nil)
|
|
535
|
-
click_table_row_with_text(browser, :id, what, text, desc, column)
|
|
536
|
-
end
|
|
537
|
-
|
|
538
|
-
# Click the first row which contains a particular string in a table identified by its index
|
|
539
|
-
# in the array of tables contained in <b>*browser*</b>.
|
|
540
|
-
# A specific column in the table can also be specified.
|
|
541
|
-
#
|
|
542
|
-
# @param (see #click_table_row_with_text_by_id)
|
|
543
|
-
# @return (see #click)
|
|
544
|
-
#
|
|
545
|
-
def click_table_row_with_text_by_index(browser, what, text, desc = '', column = nil)
|
|
546
|
-
click_table_row_with_text(browser, :id, what, text, desc, column)
|
|
547
|
-
end
|
|
548
|
-
|
|
549
|
-
# Double click the first row which contains a particular string in a table identified by the value in its *:id* attribute.
|
|
550
|
-
# A specific column in the table can also be specified.
|
|
551
|
-
#
|
|
552
|
-
# @param (see #click_table_row_with_text_by_id)
|
|
553
|
-
# @return (see #click)
|
|
554
|
-
#
|
|
555
|
-
def double_click_table_row_with_text_by_id(browser, what, text, desc = '', column = nil)
|
|
556
|
-
double_click_table_row_with_text(browser, :id, what, text, desc, column)
|
|
557
|
-
end
|
|
558
|
-
|
|
559
|
-
# Double click the first row which contains a particular string in a table identified by its index
|
|
560
|
-
# in the array of tables contained in <b>*browser*</b>.
|
|
561
|
-
# A specific column in the table can also be specified.
|
|
562
|
-
# @param (see #click_table_row_with_text_by_id)
|
|
563
|
-
# @return (see #click)
|
|
564
|
-
#
|
|
565
|
-
def double_click_table_row_with_text_by_index(browser, idx, what, column = nil)
|
|
566
|
-
double_click_table_row_with_text(browser, :index, what, text, desc, column)
|
|
567
|
-
end
|
|
568
|
-
|
|
569
|
-
# @!endgroup Tables
|
|
570
|
-
|
|
571
|
-
# @!group Core
|
|
572
|
-
|
|
573
188
|
# Click a specifific button on a popup window.
|
|
574
189
|
# (Windows only)
|
|
575
190
|
# @param [String] title A string starting at the beginning of the title which uniquely identifies the popup window.
|
|
@@ -611,7 +226,7 @@ module Awetestlib
|
|
|
611
226
|
# @param [Boolean] nofail If true do not log a failed message if the option is not found in the select list.
|
|
612
227
|
# @return (see #click)
|
|
613
228
|
def select_option_from_list(list, how, what, desc = '', nofail = false)
|
|
614
|
-
msg = build_message("Select :#{how}=>'#{what}", desc)
|
|
229
|
+
msg = build_message("Select :#{how}=>'#{what}'", desc)
|
|
615
230
|
ok = true
|
|
616
231
|
if list
|
|
617
232
|
case how
|
|
@@ -656,97 +271,10 @@ module Awetestlib
|
|
|
656
271
|
# @return (see #click)
|
|
657
272
|
def select_option(browser, how, what, which, option, desc = '', nofail = false)
|
|
658
273
|
list = browser.select_list(how, what)
|
|
659
|
-
msg
|
|
274
|
+
msg = build_message("from list with :#{how}=>'#{what}", desc)
|
|
660
275
|
select_option_from_list(list, which, option, msg, nofail)
|
|
661
276
|
end
|
|
662
277
|
|
|
663
|
-
# @!endgroup Core
|
|
664
|
-
|
|
665
|
-
# @!group Select
|
|
666
|
-
|
|
667
|
-
# Select option from select list (dropdown) identified by the value in its *:id* attribute. Option is identified by *which* and *value*
|
|
668
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
669
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
670
|
-
# @param [String/Rexexp] option A string or regular expression that will uniquely identify the option to select.
|
|
671
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
672
|
-
# @param [Boolean] nofail If true do not log a failed message if the option is not found in the select list.
|
|
673
|
-
# @return (see #click)
|
|
674
|
-
def select_option_by_id_and_option_text(browser, what, option, nofail = false, desc = '')
|
|
675
|
-
select_option(browser, :id, what, :text, option, desc, nofail)
|
|
676
|
-
end
|
|
677
|
-
|
|
678
|
-
alias select_option_by_id select_option_by_id_and_option_text
|
|
679
|
-
alias select_option_by_id_and_text select_option_by_id_and_option_text
|
|
680
|
-
|
|
681
|
-
# Select option from select list (dropdown) identified by the value in its *:name* attribute. Option is selected by its *:text* attribute.
|
|
682
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
683
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
684
|
-
# @param [String/Rexexp] option A string or regular expression that will uniquely identify the option to select.
|
|
685
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
686
|
-
# @return (see #click)
|
|
687
|
-
def select_option_by_name_and_option_text(browser, what, option, desc = '')
|
|
688
|
-
select_option(browser, :name, what, :text, option, desc)
|
|
689
|
-
end
|
|
690
|
-
|
|
691
|
-
alias select_option_by_name select_option_by_name_and_option_text
|
|
692
|
-
|
|
693
|
-
# Select option from select list (dropdown) identified by the value in its *:name* attribute. Option is selected by its *:text* attribute.
|
|
694
|
-
# @param (see #select_option_by_name_and_option_text)
|
|
695
|
-
# @return (see #click)
|
|
696
|
-
def select_option_by_title_and_option_text(browser, what, option, desc = '')
|
|
697
|
-
select_option(browser, :title, what, :text, option, desc)
|
|
698
|
-
end
|
|
699
|
-
|
|
700
|
-
# Select option from select list (dropdown) identified by the value in its *:class* attribute. Option is selected by its *:text* attribute.
|
|
701
|
-
# @param (see #select_option_by_name_and_option_text)
|
|
702
|
-
# @return (see #click)
|
|
703
|
-
def select_option_by_class_and_option_text(browser, what, option, desc = '')
|
|
704
|
-
select_option(browser, :class, what, :text, option, desc)
|
|
705
|
-
end
|
|
706
|
-
|
|
707
|
-
# Select option from select list (dropdown) identified by the value in its *:name* attribute. Option is selected by its *:value* attribute.
|
|
708
|
-
# @param (see #select_option_by_name_and_option_text)
|
|
709
|
-
# @return (see #click)
|
|
710
|
-
def select_option_by_name_and_option_value(browser, what, option, desc = '')
|
|
711
|
-
select_option(browser, :name, what, :value, option, desc)
|
|
712
|
-
end
|
|
713
|
-
|
|
714
|
-
# Select option from select list (dropdown) identified by the value in its *:id* attribute. Option is selected by its *:value* attribute.
|
|
715
|
-
# @param (see #select_option_by_name_and_option_text)
|
|
716
|
-
# @return (see #click)
|
|
717
|
-
def select_option_by_id_and_option_value(browser, what, option, desc = '')
|
|
718
|
-
select_option(browser, :id, what, :value, option, desc)
|
|
719
|
-
end
|
|
720
|
-
|
|
721
|
-
# Select option from select list (dropdown) identified by the value in its *:id* attribute.
|
|
722
|
-
# Option is selected by its index withing the select list's array of options.
|
|
723
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
724
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
725
|
-
# @param [Fixnum] index An integer that indicates the index of the element within the array of options.
|
|
726
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
727
|
-
# @return (see #click)
|
|
728
|
-
def select_option_by_id_and_index(browser, what, index, desc = '')
|
|
729
|
-
select_option(browser, :id, what, :index, index, desc)
|
|
730
|
-
end
|
|
731
|
-
|
|
732
|
-
# Select option from select list (dropdown) identified by the value in its *:name* attribute. Option is selected by its *:index* attribute.
|
|
733
|
-
# @param (see #select_option_by_id_and_index)
|
|
734
|
-
# @return (see #click)
|
|
735
|
-
def select_option_by_name_and_index(browser, what, option, desc = '')
|
|
736
|
-
select_option(browser, :name, what, :index, option, desc)
|
|
737
|
-
end
|
|
738
|
-
|
|
739
|
-
# Select option from select list (dropdown) identified by the xpath command supplied in *what*. Option is selected by its *:index* attribute.
|
|
740
|
-
# @param (see #select_option_by_id_and_index)
|
|
741
|
-
# @return (see #click)
|
|
742
|
-
def select_option_by_xpath_and_index(browser, what, option, desc = '')
|
|
743
|
-
select_option(browser, :xpath, what, :index, option, desc)
|
|
744
|
-
end
|
|
745
|
-
|
|
746
|
-
# @!endgroup Select
|
|
747
|
-
|
|
748
|
-
# @!group Core
|
|
749
|
-
|
|
750
278
|
# Set radio button or checkbox to selected.
|
|
751
279
|
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
752
280
|
# @param [Symbol] element The kind of element to click. Must be either :radio or :checkbox.
|
|
@@ -769,13 +297,13 @@ module Awetestlib
|
|
|
769
297
|
else
|
|
770
298
|
failed_to_log("#{__method__}: #{element} not supported")
|
|
771
299
|
end
|
|
772
|
-
|
|
773
|
-
|
|
300
|
+
passed_to_log(msg)
|
|
301
|
+
true
|
|
774
302
|
rescue
|
|
775
|
-
|
|
776
|
-
|
|
303
|
+
failed_to_log("#{msg} '#{$!}'")
|
|
304
|
+
end
|
|
777
305
|
|
|
778
|
-
# Set file field element, identified by *how* and
|
|
306
|
+
# Set file field element, identified by *how* and *what*, to a specified file path and name.
|
|
779
307
|
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
780
308
|
# @param [Symbol] how The element attribute used to identify the specific element.
|
|
781
309
|
# Valid values depend on the kind of element.
|
|
@@ -785,13 +313,13 @@ module Awetestlib
|
|
|
785
313
|
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
786
314
|
# @return (see #click)
|
|
787
315
|
def set_file_field(browser, how, what, filespec, desc = '')
|
|
788
|
-
msg = build_message("
|
|
789
|
-
ff
|
|
316
|
+
msg = build_message("#{__method__.to_s.humanize} #{how}=>#{what} to '#{filespec}.", desc)
|
|
317
|
+
ff = browser.file_field(how, what)
|
|
790
318
|
if ff
|
|
791
319
|
ff.set filespec
|
|
792
320
|
sleep_for(8)
|
|
793
|
-
|
|
794
|
-
|
|
321
|
+
passed_to_log(msg)
|
|
322
|
+
true
|
|
795
323
|
else
|
|
796
324
|
failed_to_log("#{msg} File field not found.")
|
|
797
325
|
end
|
|
@@ -812,8 +340,8 @@ module Awetestlib
|
|
|
812
340
|
def set_radio_two_attributes(browser, how1, what1, how2, what2, desc = '')
|
|
813
341
|
msg = build_message("Set radio #{how1}='#{what1}', #{how2}= #{what2}", desc)
|
|
814
342
|
browser.radio(how1 => what1, how2 => what2).set
|
|
815
|
-
|
|
816
|
-
|
|
343
|
+
passed_to_log(msg)
|
|
344
|
+
true
|
|
817
345
|
rescue
|
|
818
346
|
failed_to_log("#{msg} '#{$!}'")
|
|
819
347
|
end
|
|
@@ -834,188 +362,6 @@ module Awetestlib
|
|
|
834
362
|
# failed_to_log("#{msg} (#{__LINE__})")
|
|
835
363
|
#end
|
|
836
364
|
|
|
837
|
-
# @!endgroup Core
|
|
838
|
-
|
|
839
|
-
# @!group Set
|
|
840
|
-
|
|
841
|
-
# Set checkbox as checked. Checkbox is identified by the attribute specified in *how* with value *what*. It's *:value* attribute can also be used
|
|
842
|
-
# when needed by specifying *value*.
|
|
843
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
844
|
-
# @param [Symbol] how The element attribute used to identify the specific checkbox.
|
|
845
|
-
# Valid values depend on the kind of element.
|
|
846
|
-
# Common values: :text, :id, :title, :name, :class, :href (:link only)
|
|
847
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the checkbox.
|
|
848
|
-
# @param [String, Regexp] value A string or a regular expression to be found in the *:value* attribute of the checkbox.
|
|
849
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
850
|
-
# @return (see #click)
|
|
851
|
-
def set_checkbox(browser, how, what, value = nil, desc = '')
|
|
852
|
-
set(browser, :checkbox, how, what, value, desc)
|
|
853
|
-
end
|
|
854
|
-
|
|
855
|
-
# Set checkbox as checked identified by its *:class* attribute with the value in *what*. It's *:value* attribute can also be used
|
|
856
|
-
# when needed by specifying *value*.
|
|
857
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
858
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the checkbox.
|
|
859
|
-
# @param [String, Regexp] value A string or a regular expression to be found in the *:value* attribute of the checkbox.
|
|
860
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
861
|
-
# @return (see #click)
|
|
862
|
-
def set_checkbox_by_class(browser, what, value = nil, desc = '')
|
|
863
|
-
set(browser, :checkbox, :class, what, value, desc)
|
|
864
|
-
end
|
|
865
|
-
|
|
866
|
-
# Set checkbox as checked identified by its *:class* attribute with the value in *what*. It's *:value* attribute can also be used
|
|
867
|
-
# when needed by specifying *value*.
|
|
868
|
-
# @param (see #set_checkbox_by_class)
|
|
869
|
-
# @return (see #click)
|
|
870
|
-
def set_checkbox_by_id(browser, what, value = nil, desc = '')
|
|
871
|
-
set(browser, :checkbox, :id, what, value, desc)
|
|
872
|
-
end
|
|
873
|
-
|
|
874
|
-
# Set checkbox as checked identified by its *:name* attribute with the value in *what*. It's *:value* attribute can also be used
|
|
875
|
-
# when needed by specifying *value*.
|
|
876
|
-
# @param (see #set_checkbox_by_class)
|
|
877
|
-
# @return (see #click)
|
|
878
|
-
def set_checkbox_by_name(browser, what, value = nil, desc = '')
|
|
879
|
-
set(browser, :checkbox, :name, what, value, desc)
|
|
880
|
-
end
|
|
881
|
-
|
|
882
|
-
# Set checkbox as checked identified by its *:title* attribute with the value in *what*. It's *:value* attribute can also be used
|
|
883
|
-
# when needed by specifying *value*.
|
|
884
|
-
# @param (see #set_checkbox_by_class)
|
|
885
|
-
# @return (see #click)
|
|
886
|
-
def set_checkbox_by_title(browser, what, value = nil, desc = '')
|
|
887
|
-
set(browser, :checkbox, :title, what, value, desc)
|
|
888
|
-
end
|
|
889
|
-
|
|
890
|
-
# Set checkbox as checked identified by its *:value* attribute with the value in *what*.
|
|
891
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
892
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the checkbox.
|
|
893
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
894
|
-
# @return (see #click)
|
|
895
|
-
def set_checkbox_by_value(browser, what, desc = '')
|
|
896
|
-
set(browser, :checkbox, :value, what, nil, desc)
|
|
897
|
-
end
|
|
898
|
-
|
|
899
|
-
# Set radio button as set. Radio is identified by the attribute specified in *how* with value *what*. It's *:value* attribute can also be used
|
|
900
|
-
# when needed by specifying *value*.
|
|
901
|
-
# @param (see #set_checkbox)
|
|
902
|
-
# @return (see #click)
|
|
903
|
-
def set_radio(browser, how, what, value = nil, desc = '')
|
|
904
|
-
set(browser, :radio, how, what, value, desc)
|
|
905
|
-
end
|
|
906
|
-
|
|
907
|
-
# Set radio button as set identified by its *:class* attribute with the value in *what*. It's *:value* attribute can also be used
|
|
908
|
-
# when needed by specifying *value*.
|
|
909
|
-
# @param (see #set_checkbox_by_class)
|
|
910
|
-
def set_radio_by_class(browser, what, value = nil, desc = '')
|
|
911
|
-
set(browser, :radio, :class, what, value, desc)
|
|
912
|
-
end
|
|
913
|
-
|
|
914
|
-
# Set radio button as set identified by its *:id* attribute with the value in *what*. It's *:value* attribute can also be used
|
|
915
|
-
# when needed by specifying *value*.
|
|
916
|
-
# @param (see #set_checkbox_by_class)
|
|
917
|
-
# @return (see #click)
|
|
918
|
-
def set_radio_by_id(browser, what, value = nil, desc = '')
|
|
919
|
-
set(browser, :radio, :id, what, value, desc)
|
|
920
|
-
end
|
|
921
|
-
|
|
922
|
-
# Set radio button as set identified by its index within the array of radio buttons found in the container specified by *browser*.
|
|
923
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
924
|
-
# @param [Fixnum] index An integer that indicates the index of the element within *browser*.
|
|
925
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
926
|
-
# @return (see #click)
|
|
927
|
-
def set_radio_by_index(browser, index, desc = '')
|
|
928
|
-
set(browser, :radio, :index, index, nil, desc)
|
|
929
|
-
end
|
|
930
|
-
|
|
931
|
-
# Set radio button as set identified by its *:name* attribute with the value in *what*. It's *:value* attribute can also be used
|
|
932
|
-
# when needed by specifying *value*.
|
|
933
|
-
# @param (see #set_checkbox_by_class)
|
|
934
|
-
# @return (see #click)
|
|
935
|
-
def set_radio_by_name(browser, what, value = nil, desc = '')
|
|
936
|
-
set(browser, :radio, :name, what, value, desc)
|
|
937
|
-
end
|
|
938
|
-
|
|
939
|
-
# Set radio button as set identified by its *:title* attribute with the value in *what*. It's *:value* attribute can also be used
|
|
940
|
-
# when needed by specifying *value*.
|
|
941
|
-
# @param (see #set_checkbox_by_class)
|
|
942
|
-
# @return (see #click)
|
|
943
|
-
def set_radio_by_title(browser, what, value = nil, desc = '')
|
|
944
|
-
set(browser, :radio, :title, what, value, desc)
|
|
945
|
-
end
|
|
946
|
-
|
|
947
|
-
# Set radio button as set identified by its *:value* attribute with the value in *what*.
|
|
948
|
-
# @param (see #set_checkbox_by_value)
|
|
949
|
-
# @return (see #click)
|
|
950
|
-
def set_radio_by_value(browser, what, desc = '')
|
|
951
|
-
set(browser, :radio, :value, what, nil, desc)
|
|
952
|
-
end
|
|
953
|
-
|
|
954
|
-
# Set radio button as set identified by its *:name* attribute with the value in *what*
|
|
955
|
-
# and its index within the array of radio buttons with that :name
|
|
956
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
957
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the *:name* attribute that identifies the group of radio buttons.
|
|
958
|
-
# @param [Fixnum] index An integer that indicates the index of the radio button to be set.
|
|
959
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
960
|
-
# @return (see #click)
|
|
961
|
-
def set_radio_by_name_and_index(browser, what, index, desc = '')
|
|
962
|
-
set_radio_two_attributes(browser, :name, what, :index, index, desc)
|
|
963
|
-
end
|
|
964
|
-
|
|
965
|
-
# Set radio button as set identified by its *:name* attribute with the value in *what*
|
|
966
|
-
# and its index within the array of radio buttons with that :name
|
|
967
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
968
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the *:name* attribute that identifies the group of radio buttons.
|
|
969
|
-
# @param [String, Regexp] text A string or a regular expression to be found in the *:text* attribute that uniquely identifies the the radio button to be set.
|
|
970
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
971
|
-
# @return (see #click)
|
|
972
|
-
def set_radio_by_name_and_text(browser, what, text, desc = '')
|
|
973
|
-
set_radio_two_attributes(browser, :name, what, :text, text, desc)
|
|
974
|
-
end
|
|
975
|
-
|
|
976
|
-
# Set radio button as set identified by its *:value* attribute with the value in *what*
|
|
977
|
-
# and its index within the array of radio buttons with that :name
|
|
978
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
979
|
-
# @param [String, Regexp] value A string or a regular expression to be found in the *:value* attribute that identifies the group of radio buttons.
|
|
980
|
-
# @param [Fixnum] index An integer that indicates the index of the radio button to be set.
|
|
981
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
982
|
-
# @return (see #click)
|
|
983
|
-
def set_radio_by_value_and_index(browser, value, index, desc = '')
|
|
984
|
-
set_radio_two_attributes(browser, :value, value, :index, index, desc)
|
|
985
|
-
end
|
|
986
|
-
|
|
987
|
-
# Set radio button as set identified by its *:name* attribute with the value in *what*
|
|
988
|
-
# and the *:value* attribute with the value in *value*.
|
|
989
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
990
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the *:name* attribute that identifies the group of radio buttons.
|
|
991
|
-
# @param [String, Regexp] value A string or a regular expression to be found in the *:value* attribute that uniquely identifies the the radio button to be set.
|
|
992
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
993
|
-
# @return (see #click)
|
|
994
|
-
def set_radio_by_name_and_value(browser, what, value, desc = '')
|
|
995
|
-
set_radio(browser, :name, what, value, desc)
|
|
996
|
-
end
|
|
997
|
-
|
|
998
|
-
# Set file field element, identified by its *:name* attribute with the value in *what*.
|
|
999
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
1000
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
1001
|
-
# @param [String] filespec The full path and name of the target file.
|
|
1002
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
1003
|
-
# @return (see #click)
|
|
1004
|
-
def set_file_field_by_name(browser, what, filespec, desc = '')
|
|
1005
|
-
set_file_field(browser, :name, what, filespec, desc)
|
|
1006
|
-
end
|
|
1007
|
-
|
|
1008
|
-
# Set file field element, identified by its *:id* attribute with the value in *what*.
|
|
1009
|
-
# @param (see #set_file_field_by_name)
|
|
1010
|
-
# @return (see #click)
|
|
1011
|
-
def set_file_field_by_id(browser, what, filespec, desc = '')
|
|
1012
|
-
set_file_field(browser, :id, what, filespec, desc)
|
|
1013
|
-
end
|
|
1014
|
-
|
|
1015
|
-
# @!endgroup Set
|
|
1016
|
-
|
|
1017
|
-
# @!group Core
|
|
1018
|
-
|
|
1019
365
|
# Clear (unset) radio, checkbox or text field as identified by the attribute specified in *how* with value *what*.
|
|
1020
366
|
# It's *:value* attribute can also be used when needed by specifying *value* (Ignored for text_field).
|
|
1021
367
|
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
@@ -1042,68 +388,12 @@ module Awetestlib
|
|
|
1042
388
|
else
|
|
1043
389
|
failed_to_log("#{__method__}: #{element} not supported")
|
|
1044
390
|
end
|
|
1045
|
-
|
|
1046
|
-
|
|
391
|
+
passed_to_log(msg)
|
|
392
|
+
true
|
|
1047
393
|
rescue
|
|
1048
394
|
failed_to_log("#{msg} '#{$!}'")
|
|
1049
395
|
end
|
|
1050
396
|
|
|
1051
|
-
# @!endgroup Core
|
|
1052
|
-
|
|
1053
|
-
# @!group Clear
|
|
1054
|
-
|
|
1055
|
-
# Clear (uncheck) checkbox identified by the attribute specified in *how* with value *what*.
|
|
1056
|
-
# It's *:value* attribute can also be used when needed by specifying *value*.
|
|
1057
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
1058
|
-
# @param [Symbol] how The element attribute used to identify the specific checkbox.
|
|
1059
|
-
# Valid values depend on the kind of element.
|
|
1060
|
-
# Common values: :text, :id, :title, :name, :class.
|
|
1061
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
1062
|
-
# @param [String, Regexp] value A string or a regular expression to be found in the *:value* attribute of the element.
|
|
1063
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
1064
|
-
# @return (see #click)
|
|
1065
|
-
def clear_checkbox(browser, how, what, value = nil, desc = '')
|
|
1066
|
-
clear(browser, :checkbox, how, what, value, desc)
|
|
1067
|
-
end
|
|
1068
|
-
|
|
1069
|
-
# Clear (uncheck) checkbox identified by its *:name* attribute with value *what*.
|
|
1070
|
-
# It's *:value* attribute can also be used when needed by specifying *value*.
|
|
1071
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
1072
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
1073
|
-
# @param [String, Regexp] value A string or a regular expression to be found in the *:value* attribute of the element.
|
|
1074
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
1075
|
-
# @return (see #click)
|
|
1076
|
-
def clear_checkbox_by_name(browser, what, value = nil, desc = '')
|
|
1077
|
-
clear(browser, :checkbox, :name, what, value, desc)
|
|
1078
|
-
end
|
|
1079
|
-
|
|
1080
|
-
# Clear (uncheck) checkbox identified by its *:id* attribute with value *what*.
|
|
1081
|
-
# It's *:value* attribute can also be used when needed by specifying *value*.
|
|
1082
|
-
# @param (see #set_file_field_by_name)
|
|
1083
|
-
# @return (see #click)
|
|
1084
|
-
def clear_checkbox_by_name(browser, what, value = nil, desc = '')
|
|
1085
|
-
clear(browser, :checkbox, :id, what, value, desc)
|
|
1086
|
-
end
|
|
1087
|
-
|
|
1088
|
-
# Clear (unset) radio button identified by the attribute specified in *how* with value *what*.
|
|
1089
|
-
# It's *:value* attribute can also be used when needed by specifying *value*.
|
|
1090
|
-
# This clears the specified radio without setting any other radio buttons on.
|
|
1091
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
1092
|
-
# @param [Symbol] how The element attribute used to identify the specific checkbox.
|
|
1093
|
-
# Valid values depend on the kind of element.
|
|
1094
|
-
# Common values: :text, :id, :title, :name, :class.
|
|
1095
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
1096
|
-
# @param [String, Regexp] value A string or a regular expression to be found in the *:value* attribute of the element.
|
|
1097
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
1098
|
-
# @return (see #click)
|
|
1099
|
-
def clear_radio(browser, how, what, value = nil, desc = '')
|
|
1100
|
-
clear(browser, :radio, how, what, value, desc)
|
|
1101
|
-
end
|
|
1102
|
-
|
|
1103
|
-
# @!endgroup Clear
|
|
1104
|
-
|
|
1105
|
-
# @!group Core
|
|
1106
|
-
|
|
1107
397
|
# Set text field as identified by the attribute specified in *how* with value in *what* to the string specified in *value*.
|
|
1108
398
|
# This method differs from set() in that it validates that the text field has been set to the specified value.
|
|
1109
399
|
# The value verification can be turned off by setting *skip_value_check* to true.
|
|
@@ -1119,23 +409,24 @@ module Awetestlib
|
|
|
1119
409
|
# @return (see #click)
|
|
1120
410
|
def set_text_field(browser, how, what, value, desc = '', skip_value_check = false)
|
|
1121
411
|
#TODO: fix this to handle Safari password field
|
|
1122
|
-
msg = build_message("
|
|
412
|
+
msg = build_message("#{__method__.to_s.humanize} #{how}='#{what}' to '#{value}'", desc)
|
|
1123
413
|
msg << " (Skip value check)" if skip_value_check
|
|
1124
414
|
if browser.text_field(how, what).exists?
|
|
1125
415
|
tf = browser.text_field(how, what)
|
|
1126
|
-
|
|
1127
|
-
|
|
1128
|
-
|
|
1129
|
-
|
|
1130
|
-
|
|
1131
|
-
|
|
1132
|
-
|
|
1133
|
-
|
|
1134
|
-
|
|
1135
|
-
|
|
1136
|
-
|
|
416
|
+
tf.set(value)
|
|
417
|
+
if skip_value_check
|
|
418
|
+
passed_to_log(msg)
|
|
419
|
+
true
|
|
420
|
+
else
|
|
421
|
+
if tf.value == value
|
|
422
|
+
passed_to_log(msg)
|
|
423
|
+
true
|
|
424
|
+
else
|
|
425
|
+
failed_to_log("#{msg}: Found:'#{tf.value}'.")
|
|
426
|
+
end
|
|
427
|
+
end
|
|
1137
428
|
else
|
|
1138
|
-
failed_to_log("#{msg}: Textfield
|
|
429
|
+
failed_to_log("#{msg}: Textfield not found")
|
|
1139
430
|
end
|
|
1140
431
|
rescue
|
|
1141
432
|
failed_to_log("Unable to '#{msg}': '#{$!}'")
|
|
@@ -1156,23 +447,25 @@ module Awetestlib
|
|
|
1156
447
|
# @param [Boolean] skip_value_check Forces verification of value in text field to pass.
|
|
1157
448
|
# @return (see #click)
|
|
1158
449
|
def clear_textfield(browser, how, what, skip_value_check = false)
|
|
450
|
+
msg1 = "Skip value check." if skip_value_check
|
|
451
|
+
msg = build_message("#{__method__.to_s.humanize} #{how}='#{what}'.", msg1)
|
|
1159
452
|
if browser.text_field(how, what).exists?
|
|
1160
453
|
tf = browser.text_field(how, what)
|
|
1161
|
-
|
|
1162
|
-
|
|
1163
|
-
|
|
1164
|
-
|
|
1165
|
-
|
|
1166
|
-
|
|
1167
|
-
|
|
1168
|
-
|
|
1169
|
-
|
|
1170
|
-
|
|
454
|
+
tf.clear
|
|
455
|
+
if tf.value == ''
|
|
456
|
+
passed_to_log(msg)
|
|
457
|
+
true
|
|
458
|
+
elsif skip_value_check
|
|
459
|
+
passed_to_log(msg)
|
|
460
|
+
true
|
|
461
|
+
else
|
|
462
|
+
failed_to_log("#{msg} Found:'#{tf.value}'.")
|
|
463
|
+
end
|
|
1171
464
|
else
|
|
1172
|
-
failed_to_log("
|
|
465
|
+
failed_to_log("#{msg} Textfield not found.")
|
|
1173
466
|
end
|
|
1174
467
|
rescue
|
|
1175
|
-
failed_to_log("
|
|
468
|
+
failed_to_log("Unable to #{msg} '#{$!}'.")
|
|
1176
469
|
end
|
|
1177
470
|
|
|
1178
471
|
#Enter a string into a text field element identified by an attribute type and a value.
|
|
@@ -1198,7 +491,7 @@ module Awetestlib
|
|
|
1198
491
|
#NOTE: use when value and valid_value differ as with dollar reformatting
|
|
1199
492
|
if set_text_field(browser, how, what, value, desc, true)
|
|
1200
493
|
expected = valid_value ? valid_value : value
|
|
1201
|
-
validate_textfield_value(browser, how, what, expected)
|
|
494
|
+
validate_textfield_value(browser, how, what, expected, desc)
|
|
1202
495
|
end
|
|
1203
496
|
rescue
|
|
1204
497
|
failed_to_log("Unable to '#{msg}': '#{$!}'")
|
|
@@ -1230,53 +523,6 @@ module Awetestlib
|
|
|
1230
523
|
# failed_to_log("Textfield name='#{name}' could not be set to '#{value}': '#{$!}'. #{desc} (#{__LINE__})")
|
|
1231
524
|
#end
|
|
1232
525
|
|
|
1233
|
-
# @!endgroup Core
|
|
1234
|
-
|
|
1235
|
-
# @!group Set
|
|
1236
|
-
|
|
1237
|
-
# Set text field as identified by its *:name* attribute with value in *what* to the string specified in *value*.
|
|
1238
|
-
# This method validates that the text field has been set to the specified value.
|
|
1239
|
-
# The value verification can be turned off by setting *skip_value_check* to true.
|
|
1240
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
1241
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the specified attribute that uniquely identifies the element.
|
|
1242
|
-
# @param [String] value A string to enter into the text field.
|
|
1243
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output.
|
|
1244
|
-
# Required if *skip_value_check* is set to true.
|
|
1245
|
-
# @param [Boolean] skip_value_check Forces verification of value in text field to pass.
|
|
1246
|
-
# @return (see #click)
|
|
1247
|
-
def set_textfield_by_name(browser, what, value, desc = '', skip_value_check = false)
|
|
1248
|
-
set_text_field(browser, :name, what, value, desc, skip_value_check)
|
|
1249
|
-
end
|
|
1250
|
-
|
|
1251
|
-
# Set text field as identified by its *:id* attribute with value in *what* to the string specified in *value*.
|
|
1252
|
-
# This method validates that the text field has been set to the specified value.
|
|
1253
|
-
# The value verification can be turned off by setting *skip_value_check* to true.
|
|
1254
|
-
# @param (see #set_textfield_by_name)
|
|
1255
|
-
# @return (see #click)
|
|
1256
|
-
def set_textfield_by_id(browser, what, value, desc = '', skip_value_check = false)
|
|
1257
|
-
set_text_field(browser, :id, what, value, desc, skip_value_check)
|
|
1258
|
-
end
|
|
1259
|
-
|
|
1260
|
-
# Set text field as identified by its *:class* attribute with value in *what* to the string specified in *value*.
|
|
1261
|
-
# This method validates that the text field has been set to the specified value.
|
|
1262
|
-
# The value verification can be turned off by setting *skip_value_check* to true.
|
|
1263
|
-
# @param (see #set_textfield_by_name)
|
|
1264
|
-
# @return (see #click)
|
|
1265
|
-
def set_textfield_by_title(browser, what, value, desc = '', skip_value_check = false)
|
|
1266
|
-
set_text_field(browser, :title, what, value, desc, skip_value_check)
|
|
1267
|
-
end
|
|
1268
|
-
|
|
1269
|
-
# Set text field as identified by its *:class* attribute with value in *what* to the string specified in *value*.
|
|
1270
|
-
# This method validates that the text field has been set to the specified value.
|
|
1271
|
-
# The value verification can be turned off by setting *skip_value_check* to true.
|
|
1272
|
-
# @param (see #set_textfield_by_name)
|
|
1273
|
-
def set_textfield_by_class(browser, what, value, desc = '', skip_value_check = false)
|
|
1274
|
-
set_text_field(browser, :class, what, value, desc, skip_value_check)
|
|
1275
|
-
end
|
|
1276
|
-
|
|
1277
|
-
# @!endgroup Set
|
|
1278
|
-
# @!group Core
|
|
1279
|
-
|
|
1280
526
|
# Fire an event on a specific DOM element identified by one of its attributes and that attribute's value.
|
|
1281
527
|
#
|
|
1282
528
|
# @example
|
|
@@ -1297,8 +543,7 @@ module Awetestlib
|
|
|
1297
543
|
# @return (see #click)
|
|
1298
544
|
#
|
|
1299
545
|
def fire_event(browser, element, how, what, event, desc = '')
|
|
1300
|
-
msg
|
|
1301
|
-
msg1 = "#{element.to_s.titlecase}(#{how}, '#{what}')"
|
|
546
|
+
msg = build_message("#{element.to_s.titlecase}: #{how}=>'#{what}' event:'#{event}'", desc)
|
|
1302
547
|
begin
|
|
1303
548
|
case element
|
|
1304
549
|
when :link
|
|
@@ -1315,73 +560,16 @@ module Awetestlib
|
|
|
1315
560
|
browser.element(how, what).fire_event(event)
|
|
1316
561
|
end
|
|
1317
562
|
rescue => e
|
|
1318
|
-
|
|
563
|
+
unless rescue_me(e, __method__, rescue_me_command(element, how, what, __method__.to_s, event), "#{browser.class}")
|
|
1319
564
|
raise e
|
|
1320
565
|
end
|
|
1321
566
|
end
|
|
1322
|
-
|
|
1323
|
-
|
|
567
|
+
passed_to_log("Fire event: #{msg}. #{desc}")
|
|
568
|
+
true
|
|
1324
569
|
rescue
|
|
1325
570
|
failed_to_log("Unable to fire event: #{msg}. '#{$!}' #{desc}")
|
|
1326
571
|
end
|
|
1327
572
|
|
|
1328
|
-
# @!endgroup Core
|
|
1329
|
-
|
|
1330
|
-
# @!group Fire Event
|
|
1331
|
-
|
|
1332
|
-
# Fire an event on a link element identified by the value in its text (innerHTML)
|
|
1333
|
-
#
|
|
1334
|
-
# @example
|
|
1335
|
-
# # html for a link element:
|
|
1336
|
-
# # <a href="http://pragmaticprogrammer.com/titles/ruby/" id="one" name="book">Pickaxe</a>
|
|
1337
|
-
#
|
|
1338
|
-
# fire_event_on_link_by_text(browser, 'Pickaxe', 'onMouseOver')
|
|
1339
|
-
#
|
|
1340
|
-
# @param [Watir::Browser] browser A reference to the browser window or container element to be tested.
|
|
1341
|
-
# @param [String, Regexp] what A string or a regular expression to be found in the *how* attribute that uniquely identifies the element.
|
|
1342
|
-
# @param [String] event A string identifying the event to be fired.
|
|
1343
|
-
# @param [String] desc Contains a message or description intended to appear in the log and/or report output
|
|
1344
|
-
# @return (see #click)
|
|
1345
|
-
#
|
|
1346
|
-
def fire_event_on_link_by_text(browser, what, event, desc = '')
|
|
1347
|
-
fire_event(browser, :link, :text, what, event, desc)
|
|
1348
|
-
end
|
|
1349
|
-
|
|
1350
|
-
alias fire_event_text fire_event_on_link_by_text
|
|
1351
|
-
alias fire_event_by_text fire_event_on_link_by_text
|
|
1352
|
-
|
|
1353
|
-
# Fire an event on a link element identified by the value in its *:id* attribute.
|
|
1354
|
-
#
|
|
1355
|
-
# @example
|
|
1356
|
-
# # html for a link element:
|
|
1357
|
-
# # <a href="http://pragmaticprogrammer.com/titles/ruby/" id="one" name="book">Pickaxe</a>
|
|
1358
|
-
#
|
|
1359
|
-
# fire_event_on_link_by_id(browser, 'one', 'onMouseOver')
|
|
1360
|
-
#
|
|
1361
|
-
# @param (see #fire_event_on_link_by_text)
|
|
1362
|
-
# @return (see #click)
|
|
1363
|
-
#
|
|
1364
|
-
def fire_event_on_link_by_id(browser, what, event, desc = '')
|
|
1365
|
-
fire_event(browser, :link, :id, what, event, desc)
|
|
1366
|
-
end
|
|
1367
|
-
|
|
1368
|
-
alias fire_event_id fire_event_on_link_by_id
|
|
1369
|
-
alias fire_event_by_id fire_event_on_link_by_id
|
|
1370
|
-
|
|
1371
|
-
# Fire an event on a image element identified by the value in its *:src* attribute.
|
|
1372
|
-
# Take care to escape characters in the source url that are reserved by Regexp.
|
|
1373
|
-
# @param (see #fire_event_on_link_by_text)
|
|
1374
|
-
# @return (see #click)
|
|
1375
|
-
#
|
|
1376
|
-
def fire_event_on_image_by_src(browser, what, event, desc = '')
|
|
1377
|
-
fire_event(browser, :img, :src, what, event, desc)
|
|
1378
|
-
end
|
|
1379
|
-
|
|
1380
|
-
alias fire_event_src fire_event_on_image_by_src
|
|
1381
|
-
alias fire_event_image_by_src fire_event_on_image_by_src
|
|
1382
|
-
|
|
1383
|
-
# @!endgroup Fire Event
|
|
1384
|
-
|
|
1385
573
|
end
|
|
1386
574
|
end
|
|
1387
575
|
end
|