watir 1.6.2 → 1.6.5
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGES +326 -188
- data/bin/watir-console +7 -8
- data/lib/changes.rb +3 -3
- data/lib/license.rb +38 -38
- data/lib/readme.rb +140 -140
- data/lib/watir/WindowHelper.rb +49 -49
- data/lib/watir/camel_case.rb +66 -45
- data/lib/watir/clickJSDialog.rb +19 -19
- data/lib/watir/close_all.rb +37 -37
- data/lib/watir/collections.rb +344 -312
- data/lib/watir/container.rb +815 -753
- data/lib/watir/contrib/enabled_popup.rb +20 -20
- data/lib/watir/contrib/ie-new-process.rb +27 -27
- data/lib/watir/contrib/page_checker.rb +29 -29
- data/lib/watir/cookiemanager.rb +55 -55
- data/lib/watir/core_ext.rb +18 -0
- data/lib/watir/datahandler.rb +107 -107
- data/lib/watir/dialog.rb +46 -46
- data/lib/watir/element.rb +343 -312
- data/lib/watir/element_collections.rb +97 -81
- data/lib/watir/form.rb +170 -170
- data/lib/watir/frame.rb +59 -59
- data/lib/watir/ie-class.rb +1009 -1003
- data/lib/watir/ie-process.rb +39 -39
- data/lib/watir/ie.rb +133 -132
- data/lib/watir/image.rb +130 -130
- data/lib/watir/input_elements.rb +572 -539
- data/lib/watir/irb-history.rb +30 -30
- data/lib/watir/link.rb +64 -64
- data/lib/watir/locator.rb +176 -161
- data/lib/watir/logger.rb +19 -19
- data/lib/watir/modal_dialog.rb +122 -122
- data/lib/watir/non_control_elements.rb +145 -127
- data/lib/watir/page-container.rb +107 -105
- data/lib/watir/popup.rb +29 -29
- data/lib/watir/process.rb +19 -19
- data/lib/watir/screen_capture.rb +115 -115
- data/lib/watir/setFileDialog.rb +16 -16
- data/lib/watir/table.rb +362 -362
- data/lib/watir/utils.rb +19 -19
- data/lib/watir/version.rb +5 -5
- data/lib/watir/watir_simple.rb +475 -475
- data/lib/watir/win32.rb +35 -28
- data/lib/watir/win32ole.rb +14 -6
- data/lib/watir/winClicker.rb +496 -479
- data/unittests/all_tests.rb +10 -10
- data/unittests/buttons_xpath_test.rb +69 -69
- data/unittests/checkbox_test.rb +179 -176
- data/unittests/checkbox_xpath_test.rb +107 -107
- data/unittests/core_tests.rb +17 -16
- data/unittests/css_test.rb +35 -35
- data/unittests/defer_test.rb +46 -46
- data/unittests/dialog_test.rb +77 -77
- data/unittests/div2_xpath_test.rb +21 -21
- data/unittests/div_test.rb +188 -183
- data/unittests/div_xpath_test.rb +96 -96
- data/unittests/errorchecker_test.rb +22 -22
- data/unittests/filefield_test.rb +39 -40
- data/unittests/filefield_xpath_test.rb +33 -33
- data/unittests/form_test.rb +280 -293
- data/unittests/form_xpath_test.rb +252 -253
- data/unittests/frame_test.rb +155 -157
- data/unittests/google_form_test.rb +15 -15
- data/unittests/html/JavascriptClick.html +39 -39
- data/unittests/html/blankpage.html +11 -11
- data/unittests/html/buttons1.html +40 -40
- data/unittests/html/checkboxes1.html +89 -89
- data/unittests/html/complex_table.html +36 -36
- data/unittests/html/cssTest.html +42 -42
- data/unittests/html/depot_store.html +51 -51
- data/unittests/html/div.html +93 -93
- data/unittests/html/div_xml.html +20 -20
- data/unittests/html/fileupload.html +45 -45
- data/unittests/html/formTest1.html +38 -38
- data/unittests/html/forms2.html +44 -44
- data/unittests/html/forms3.html +131 -131
- data/unittests/html/forms4.html +27 -27
- data/unittests/html/frame_buttons.html +3 -3
- data/unittests/html/frame_links.html +3 -3
- data/unittests/html/frame_multi.html +4 -4
- data/unittests/html/google_india.html +107 -107
- data/unittests/html/iframeTest.html +12 -12
- data/unittests/html/iframeTest1.html +6 -6
- data/unittests/html/iframeTest2.html +5 -5
- data/unittests/html/images1.html +66 -66
- data/unittests/html/javascriptevents.html +35 -35
- data/unittests/html/link_pass.html +10 -10
- data/unittests/html/links1.html +38 -38
- data/unittests/html/links2.html +10 -10
- data/unittests/html/links_multi.html +14 -14
- data/unittests/html/list_matters.html +720 -720
- data/unittests/html/lists.html +17 -17
- data/unittests/html/map_test.html +31 -31
- data/unittests/html/modal_dialog.html +10 -10
- data/unittests/html/modal_dialog_launcher.html +11 -11
- data/unittests/html/nestedFrames.html +6 -6
- data/unittests/html/new_browser.html +16 -16
- data/unittests/html/pass.html +12 -12
- data/unittests/html/popups1.html +59 -59
- data/unittests/html/pre.html +27 -27
- data/unittests/html/radioButtons1.html +71 -71
- data/unittests/html/select_tealeaf.html +54 -54
- data/unittests/html/selectboxes1.html +52 -55
- data/unittests/html/simple_table.html +26 -26
- data/unittests/html/simple_table_buttons.html +104 -104
- data/unittests/html/simple_table_columns.html +76 -76
- data/unittests/html/table1.html +181 -181
- data/unittests/html/tableCell_using_xpath.html +19 -19
- data/unittests/html/textarea.html +30 -30
- data/unittests/html/textfields1.html +88 -88
- data/unittests/html/textsearch.html +44 -44
- data/unittests/html/wallofcheckboxes.html +1003 -1003
- data/unittests/html/xpath_nbsp.html +12 -12
- data/unittests/ie_exists_test.rb +33 -33
- data/unittests/ie_mock.rb +94 -94
- data/unittests/ie_test.rb +51 -50
- data/unittests/images_test.rb +157 -157
- data/unittests/images_xpath_test.rb +91 -91
- data/unittests/links_multi_test.rb +48 -48
- data/unittests/links_test.rb +175 -177
- data/unittests/links_xpath_test.rb +39 -39
- data/unittests/map_test.rb +98 -98
- data/unittests/minmax_test.rb +31 -31
- data/unittests/navigate_test.rb +39 -39
- data/unittests/nbsp_xpath_test.rb +16 -16
- data/unittests/non_core_tests.rb +12 -12
- data/unittests/other/WindowLogonExample.rb +27 -27
- data/unittests/other/WindowLogonExtra.rb +6 -6
- data/unittests/other/all_tests_concurrent.rb +57 -57
- data/unittests/{windows → other}/jscriptExtraAlert.rb +6 -6
- data/unittests/{windows → other}/jscriptExtraConfirmCancel.rb +6 -6
- data/unittests/{windows → other}/jscriptExtraConfirmOk.rb +6 -6
- data/unittests/{windows → other}/jscriptPushButton.rb +6 -6
- data/unittests/{windows → other}/jscript_test.rb +63 -63
- data/unittests/other/navigate_exception_test.rb +24 -24
- data/unittests/other/rexml_unit_test.rb +27 -24
- data/unittests/other/screen_capture_test.rb +54 -54
- data/unittests/other/testcase_method_order_test.rb +35 -35
- data/unittests/other/testcase_verify_test.rb +24 -24
- data/unittests/other/wait_until_test.rb +99 -99
- data/unittests/pagecontainstext_test.rb +69 -69
- data/unittests/parent_child_test.rb +43 -43
- data/unittests/perf_test.rb +20 -20
- data/unittests/popups_test.rb +43 -43
- data/unittests/pre_test.rb +53 -53
- data/unittests/radios_test.rb +212 -212
- data/unittests/radios_xpath_test.rb +101 -101
- data/unittests/security_setting_test.rb +23 -23
- data/unittests/selectbox_test.rb +148 -139
- data/unittests/selectbox_xpath_test.rb +113 -113
- data/unittests/setup.rb +77 -75
- data/unittests/speed_settings_test.rb +67 -65
- data/unittests/table_cell_using_xpath_test.rb +35 -35
- data/unittests/table_test.rb +376 -362
- data/unittests/table_xpath_test.rb +110 -110
- data/unittests/test_tests.rb +9 -9
- data/unittests/textarea_test.rb +92 -92
- data/unittests/textarea_xpath_test.rb +78 -78
- data/unittests/textfield_for_ch_char_test.rb +31 -29
- data/unittests/textfields_test.rb +218 -218
- data/unittests/textfields_xpath_test.rb +111 -111
- data/unittests/window_tests.rb +10 -7
- data/unittests/windows/attach_to_existing_window_test.rb +53 -52
- data/unittests/windows/attach_to_new_window_test.rb +83 -82
- data/unittests/windows/close_window_test.rb +20 -20
- data/unittests/windows/frame_links_test.rb +25 -25
- data/unittests/windows/ie-each_test.rb +47 -47
- data/unittests/windows/iedialog_test.rb +54 -54
- data/unittests/windows/js_events_test.rb +55 -55
- data/unittests/windows/modal_dialog_test.rb +128 -126
- data/unittests/windows/new_test.rb +57 -55
- data/unittests/windows/open_close_test.rb +18 -18
- data/unittests/windows/send_keys_test.rb +33 -32
- data/unittests/xpath_tests.rb +10 -10
- metadata +20 -20
- data/lib/watir/contrib/visible.rb +0 -47
- data/unittests/iostring.rb +0 -30
- data/unittests/iostring_test.rb +0 -48
data/bin/watir-console
CHANGED
@@ -1,8 +1,7 @@
|
|
1
|
-
#!/usr/bin/env ruby
|
2
|
-
$root = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
|
3
|
-
$watir_lib = File.join($root, 'watir', 'lib')
|
4
|
-
$watir_common_lib = File.join($root, '
|
5
|
-
$firewatir_lib = File.join($root, 'firewatir', 'lib')
|
6
|
-
$libs = "-I #{$watir_lib} -I #{$watir_common_lib} -I #{$firewatir_lib}"
|
7
|
-
|
8
|
-
exec "irb.bat #{$libs} -r irb/completion -r watir/irb-history -r watir --simple-prompt --readline"
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
$root = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
|
3
|
+
$watir_lib = File.join($root, 'watir', 'lib')
|
4
|
+
$watir_common_lib = File.join($root, 'commonwatir', 'lib')
|
5
|
+
$firewatir_lib = File.join($root, 'firewatir', 'lib')
|
6
|
+
$libs = "-I #{$watir_lib} -I #{$watir_common_lib} -I #{$firewatir_lib}"
|
7
|
+
exec "irb.bat #{$libs} -r rubygems -r irb/completion -r watir/irb-history -r watir --simple-prompt --readline"
|
data/lib/changes.rb
CHANGED
@@ -1,3 +1,3 @@
|
|
1
|
-
=begin rdoc
|
2
|
-
:include:../CHANGES
|
3
|
-
=end
|
1
|
+
=begin rdoc
|
2
|
+
:include:../CHANGES
|
3
|
+
=end
|
data/lib/license.rb
CHANGED
@@ -1,38 +1,38 @@
|
|
1
|
-
=begin rdoc
|
2
|
-
|
3
|
-
License
|
4
|
-
---------------------------------------------------------------------------
|
5
|
-
Copyright (c) 2004 - 2005, Paul Rogers and Bret Pettichord
|
6
|
-
Copyright (c) 2006 - 2008, Bret Pettichord
|
7
|
-
All rights reserved.
|
8
|
-
|
9
|
-
Redistribution and use in source and binary forms, with or without
|
10
|
-
modification, are permitted provided that the following conditions are met:
|
11
|
-
|
12
|
-
1. Redistributions of source code must retain the above copyright notice,
|
13
|
-
this list of conditions and the following disclaimer.
|
14
|
-
|
15
|
-
2. Redistributions in binary form must reproduce the above copyright
|
16
|
-
notice, this list of conditions and the following disclaimer in the
|
17
|
-
documentation and/or other materials provided with the distribution.
|
18
|
-
|
19
|
-
3. Neither the names Paul Rogers, Bret Pettichord nor the names of contributors to
|
20
|
-
this software may be used to endorse or promote products derived from this
|
21
|
-
software without specific prior written permission.
|
22
|
-
|
23
|
-
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
|
24
|
-
IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
25
|
-
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
26
|
-
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
|
27
|
-
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
28
|
-
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
29
|
-
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
30
|
-
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
31
|
-
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
32
|
-
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
33
|
-
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
34
|
-
--------------------------------------------------------------------------
|
35
|
-
(based on BSD Open Source License)
|
36
|
-
|
37
|
-
=end
|
38
|
-
|
1
|
+
=begin rdoc
|
2
|
+
|
3
|
+
License
|
4
|
+
---------------------------------------------------------------------------
|
5
|
+
Copyright (c) 2004 - 2005, Paul Rogers and Bret Pettichord
|
6
|
+
Copyright (c) 2006 - 2008, Bret Pettichord
|
7
|
+
All rights reserved.
|
8
|
+
|
9
|
+
Redistribution and use in source and binary forms, with or without
|
10
|
+
modification, are permitted provided that the following conditions are met:
|
11
|
+
|
12
|
+
1. Redistributions of source code must retain the above copyright notice,
|
13
|
+
this list of conditions and the following disclaimer.
|
14
|
+
|
15
|
+
2. Redistributions in binary form must reproduce the above copyright
|
16
|
+
notice, this list of conditions and the following disclaimer in the
|
17
|
+
documentation and/or other materials provided with the distribution.
|
18
|
+
|
19
|
+
3. Neither the names Paul Rogers, Bret Pettichord nor the names of contributors to
|
20
|
+
this software may be used to endorse or promote products derived from this
|
21
|
+
software without specific prior written permission.
|
22
|
+
|
23
|
+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
|
24
|
+
IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
25
|
+
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
26
|
+
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
|
27
|
+
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
28
|
+
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
29
|
+
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
30
|
+
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
31
|
+
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
32
|
+
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
33
|
+
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
34
|
+
--------------------------------------------------------------------------
|
35
|
+
(based on BSD Open Source License)
|
36
|
+
|
37
|
+
=end
|
38
|
+
|
data/lib/readme.rb
CHANGED
@@ -1,140 +1,140 @@
|
|
1
|
-
=begin rdoc
|
2
|
-
|
3
|
-
This is Watir - Web Application Testing In Ruby http://wtr.rubyforge.org
|
4
|
-
|
5
|
-
Install Ruby http://ruby-lang.org
|
6
|
-
First you need to install Ruby using the one-click installer for Windows. We
|
7
|
-
recommend Ruby 1.8.6. (Even if you are using modal dialogs.)
|
8
|
-
|
9
|
-
Install Watir
|
10
|
-
Watir is packaged as a gem, a Ruby library that can be installed over the
|
11
|
-
internet.
|
12
|
-
|
13
|
-
Watir 1.5 was released in September 2007. To install it, type this at a
|
14
|
-
command prompt:
|
15
|
-
gem install watir
|
16
|
-
|
17
|
-
Watir 1.4 was released in August 2005. If you are upgrading from it, see
|
18
|
-
these notes: http://wiki.openqa.org/display/WTR/Development+Builds
|
19
|
-
|
20
|
-
How To Use:
|
21
|
-
This only works on Windows.
|
22
|
-
Requires Internet Explorer 5.5 or newer.
|
23
|
-
Check out the mail lists and the documentation for the workarounds.
|
24
|
-
|
25
|
-
User Guide: http://wiki.openqa.org/display/WTR/User+Guide
|
26
|
-
|
27
|
-
Unit Tests:
|
28
|
-
Run the unittests in a cmd shell. Go to the dir where you installed it and then type 'ruby unittests/core_tests.rb'.
|
29
|
-
See the user guide if you are having problems with security blocking.
|
30
|
-
|
31
|
-
Typical Usage
|
32
|
-
# include the controller
|
33
|
-
require 'watir'
|
34
|
-
# create an instance of the controller
|
35
|
-
ie = Watir::IE.new
|
36
|
-
# go to the page you want to test
|
37
|
-
ie.goto('http://myserver/mypage')
|
38
|
-
# to enter text into a text field - assuming the field is named 'username'
|
39
|
-
ie.text_field(:name, 'username').set('Paul')
|
40
|
-
# if there was a text field that had an id of 'company_ID', you could set it to 'Ruby Co':
|
41
|
-
ie.text_field(:id ,'company_ID').set('Ruby Co')
|
42
|
-
# to click a button that has a caption of 'Cancel'
|
43
|
-
ie.button(:value, 'Cancel').click
|
44
|
-
|
45
|
-
Identifying something using two or more identifying characteristics
|
46
|
-
# Html objects can also be identified via a combination of two of the above methods,
|
47
|
-
# for example to click a span with a class name of 'Label', and whose text is 'Add new', one could say
|
48
|
-
ie.span(:class =>'Label', :text => 'Add new').click
|
49
|
-
# Or to find one object within another (for example the first text_field within a div of class
|
50
|
-
# 'PasswordInput', where your password equals 'MyPassword'), one could say
|
51
|
-
ie.div(:class, 'PasswordInput').text_field(:index, 1).set('MyPassword')
|
52
|
-
|
53
|
-
The ways that are available to identify an html object depend upon the object type, but include
|
54
|
-
:id used for an object that has an ID attribute.*
|
55
|
-
:name used for an object that has a name attribute.*
|
56
|
-
:value value of text fields, captions of buttons.
|
57
|
-
:index finds the nth object of the specified type - eg button(:index , 2) finds the second button. This is 1 based. <br>
|
58
|
-
:class used for an object that has a class attribute.
|
59
|
-
:text used for links and other objects that contain text.
|
60
|
-
:xpath finds the item using xpath query
|
61
|
-
|
62
|
-
* :id and :name are the quickest of these to process, and so should be used when possible to speed up scripts.
|
63
|
-
|
64
|
-
These 2 web sites provide info on Internet Explorer and on the DOM as implemented by Internet Explorer
|
65
|
-
http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/webbrowser/webbrowser.asp
|
66
|
-
http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/overview/overview.asp
|
67
|
-
|
68
|
-
Command line options:
|
69
|
-
|
70
|
-
-b (background) Run Internet Explorer invisible
|
71
|
-
-f (fast) Run tests very fast
|
72
|
-
|
73
|
-
Note that if you also use test/unit, you will need to require 'watir' first to avoid conflicts
|
74
|
-
with its command line switches.
|
75
|
-
|
76
|
-
Javascript Pop Up Support
|
77
|
-
Watir now optionally installs AutoIt - http://www.autoitscript.com/
|
78
|
-
This is the prefered method for dealing wth pop ups, file requesters etc. Support for Winclickers will be removed.
|
79
|
-
|
80
|
-
Contacts:
|
81
|
-
Bret Pettichord (bret@pettichord.com)
|
82
|
-
Charley Baker (charley.baker@gmail.com)
|
83
|
-
Paul Rogers (paul.rogers@shaw.ca)
|
84
|
-
The mailing list: http://groups.google.com/group/watir-general
|
85
|
-
|
86
|
-
Contributors:
|
87
|
-
Bret Pettichord
|
88
|
-
Paul Rogers
|
89
|
-
Jonathan Kohl
|
90
|
-
Chris Morris
|
91
|
-
Karlin Fox
|
92
|
-
Lorenzo Jorquera
|
93
|
-
Atilla Ozgur
|
94
|
-
Justin McCarthy
|
95
|
-
Chris McMahon
|
96
|
-
Elisabeth Hendrickson
|
97
|
-
Michael Kelly
|
98
|
-
Peter Chau
|
99
|
-
Danny Faught
|
100
|
-
Andy Sipe
|
101
|
-
John Lloyd-Jones
|
102
|
-
Chris Hedges
|
103
|
-
Park Heesob
|
104
|
-
Shashank Date
|
105
|
-
Jared Luxenberg
|
106
|
-
Alexey Verkhovsky
|
107
|
-
Tuyet Cong-Ton-Nu
|
108
|
-
Jeff Wood
|
109
|
-
Angrez Singh
|
110
|
-
Abhishek Goliya
|
111
|
-
Yaxin Wang
|
112
|
-
Michael Bolton
|
113
|
-
Paul Carvalho
|
114
|
-
Konstantin Sobolev
|
115
|
-
David Schmidt
|
116
|
-
Dara Lillis
|
117
|
-
Charley Baker
|
118
|
-
Prema Arya
|
119
|
-
Xavier Noria
|
120
|
-
Jeff Fry
|
121
|
-
Zeljko Filipin
|
122
|
-
Paul Taylor - Bug fix 194
|
123
|
-
Vincent Xu - Chinese input support
|
124
|
-
Tomislav Car - Filefield fix (210)
|
125
|
-
Michael Hwee & Aidy Lewis - Multiple attribute support for FireWatir (233)
|
126
|
-
Alan Baird - Fix for visible? method (253)
|
127
|
-
Jari Bakken - Regexp support for includes? and selected? methods for select lists (261)
|
128
|
-
|
129
|
-
Acknowledgements:
|
130
|
-
Chris Morris
|
131
|
-
Brian Marick
|
132
|
-
Jonathan Kohl
|
133
|
-
Penny Tonita
|
134
|
-
Janet Gregory
|
135
|
-
Andy Tinkham
|
136
|
-
Jacinda Scott (logo creator)
|
137
|
-
|
138
|
-
Thanks for your ideas and support!
|
139
|
-
|
140
|
-
=end
|
1
|
+
=begin rdoc
|
2
|
+
|
3
|
+
This is Watir - Web Application Testing In Ruby http://wtr.rubyforge.org
|
4
|
+
|
5
|
+
Install Ruby http://ruby-lang.org
|
6
|
+
First you need to install Ruby using the one-click installer for Windows. We
|
7
|
+
recommend Ruby 1.8.6. (Even if you are using modal dialogs.)
|
8
|
+
|
9
|
+
Install Watir
|
10
|
+
Watir is packaged as a gem, a Ruby library that can be installed over the
|
11
|
+
internet.
|
12
|
+
|
13
|
+
Watir 1.5 was released in September 2007. To install it, type this at a
|
14
|
+
command prompt:
|
15
|
+
gem install watir
|
16
|
+
|
17
|
+
Watir 1.4 was released in August 2005. If you are upgrading from it, see
|
18
|
+
these notes: http://wiki.openqa.org/display/WTR/Development+Builds
|
19
|
+
|
20
|
+
How To Use:
|
21
|
+
This only works on Windows.
|
22
|
+
Requires Internet Explorer 5.5 or newer.
|
23
|
+
Check out the mail lists and the documentation for the workarounds.
|
24
|
+
|
25
|
+
User Guide: http://wiki.openqa.org/display/WTR/User+Guide
|
26
|
+
|
27
|
+
Unit Tests:
|
28
|
+
Run the unittests in a cmd shell. Go to the dir where you installed it and then type 'ruby unittests/core_tests.rb'.
|
29
|
+
See the user guide if you are having problems with security blocking.
|
30
|
+
|
31
|
+
Typical Usage
|
32
|
+
# include the controller
|
33
|
+
require 'watir'
|
34
|
+
# create an instance of the controller
|
35
|
+
ie = Watir::IE.new
|
36
|
+
# go to the page you want to test
|
37
|
+
ie.goto('http://myserver/mypage')
|
38
|
+
# to enter text into a text field - assuming the field is named 'username'
|
39
|
+
ie.text_field(:name, 'username').set('Paul')
|
40
|
+
# if there was a text field that had an id of 'company_ID', you could set it to 'Ruby Co':
|
41
|
+
ie.text_field(:id ,'company_ID').set('Ruby Co')
|
42
|
+
# to click a button that has a caption of 'Cancel'
|
43
|
+
ie.button(:value, 'Cancel').click
|
44
|
+
|
45
|
+
Identifying something using two or more identifying characteristics
|
46
|
+
# Html objects can also be identified via a combination of two of the above methods,
|
47
|
+
# for example to click a span with a class name of 'Label', and whose text is 'Add new', one could say
|
48
|
+
ie.span(:class =>'Label', :text => 'Add new').click
|
49
|
+
# Or to find one object within another (for example the first text_field within a div of class
|
50
|
+
# 'PasswordInput', where your password equals 'MyPassword'), one could say
|
51
|
+
ie.div(:class, 'PasswordInput').text_field(:index, 1).set('MyPassword')
|
52
|
+
|
53
|
+
The ways that are available to identify an html object depend upon the object type, but include
|
54
|
+
:id used for an object that has an ID attribute.*
|
55
|
+
:name used for an object that has a name attribute.*
|
56
|
+
:value value of text fields, captions of buttons.
|
57
|
+
:index finds the nth object of the specified type - eg button(:index , 2) finds the second button. This is 1 based. <br>
|
58
|
+
:class used for an object that has a class attribute.
|
59
|
+
:text used for links and other objects that contain text.
|
60
|
+
:xpath finds the item using xpath query
|
61
|
+
|
62
|
+
* :id and :name are the quickest of these to process, and so should be used when possible to speed up scripts.
|
63
|
+
|
64
|
+
These 2 web sites provide info on Internet Explorer and on the DOM as implemented by Internet Explorer
|
65
|
+
http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/webbrowser/webbrowser.asp
|
66
|
+
http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/overview/overview.asp
|
67
|
+
|
68
|
+
Command line options:
|
69
|
+
|
70
|
+
-b (background) Run Internet Explorer invisible
|
71
|
+
-f (fast) Run tests very fast
|
72
|
+
|
73
|
+
Note that if you also use test/unit, you will need to require 'watir' first to avoid conflicts
|
74
|
+
with its command line switches.
|
75
|
+
|
76
|
+
Javascript Pop Up Support
|
77
|
+
Watir now optionally installs AutoIt - http://www.autoitscript.com/
|
78
|
+
This is the prefered method for dealing wth pop ups, file requesters etc. Support for Winclickers will be removed.
|
79
|
+
|
80
|
+
Contacts:
|
81
|
+
Bret Pettichord (bret@pettichord.com)
|
82
|
+
Charley Baker (charley.baker@gmail.com)
|
83
|
+
Paul Rogers (paul.rogers@shaw.ca)
|
84
|
+
The mailing list: http://groups.google.com/group/watir-general
|
85
|
+
|
86
|
+
Contributors:
|
87
|
+
Bret Pettichord
|
88
|
+
Paul Rogers
|
89
|
+
Jonathan Kohl
|
90
|
+
Chris Morris
|
91
|
+
Karlin Fox
|
92
|
+
Lorenzo Jorquera
|
93
|
+
Atilla Ozgur
|
94
|
+
Justin McCarthy
|
95
|
+
Chris McMahon
|
96
|
+
Elisabeth Hendrickson
|
97
|
+
Michael Kelly
|
98
|
+
Peter Chau
|
99
|
+
Danny Faught
|
100
|
+
Andy Sipe
|
101
|
+
John Lloyd-Jones
|
102
|
+
Chris Hedges
|
103
|
+
Park Heesob
|
104
|
+
Shashank Date
|
105
|
+
Jared Luxenberg
|
106
|
+
Alexey Verkhovsky
|
107
|
+
Tuyet Cong-Ton-Nu
|
108
|
+
Jeff Wood
|
109
|
+
Angrez Singh
|
110
|
+
Abhishek Goliya
|
111
|
+
Yaxin Wang
|
112
|
+
Michael Bolton
|
113
|
+
Paul Carvalho
|
114
|
+
Konstantin Sobolev
|
115
|
+
David Schmidt
|
116
|
+
Dara Lillis
|
117
|
+
Charley Baker
|
118
|
+
Prema Arya
|
119
|
+
Xavier Noria
|
120
|
+
Jeff Fry
|
121
|
+
Zeljko Filipin
|
122
|
+
Paul Taylor - Bug fix 194
|
123
|
+
Vincent Xu - Chinese input support
|
124
|
+
Tomislav Car - Filefield fix (210)
|
125
|
+
Michael Hwee & Aidy Lewis - Multiple attribute support for FireWatir (233)
|
126
|
+
Alan Baird - Fix for visible? method (253)
|
127
|
+
Jari Bakken - Regexp support for includes? and selected? methods for select lists (261)
|
128
|
+
|
129
|
+
Acknowledgements:
|
130
|
+
Chris Morris
|
131
|
+
Brian Marick
|
132
|
+
Jonathan Kohl
|
133
|
+
Penny Tonita
|
134
|
+
Janet Gregory
|
135
|
+
Andy Tinkham
|
136
|
+
Jacinda Scott (logo creator)
|
137
|
+
|
138
|
+
Thanks for your ideas and support!
|
139
|
+
|
140
|
+
=end
|
data/lib/watir/WindowHelper.rb
CHANGED
@@ -1,49 +1,49 @@
|
|
1
|
-
require 'watir/win32ole'
|
2
|
-
require 'watir/ie' # for Watir.autoit
|
3
|
-
|
4
|
-
class WindowHelper
|
5
|
-
@@ie_window_name = "Windows Internet Explorer"
|
6
|
-
def initialize()
|
7
|
-
@autoit = Watir.autoit
|
8
|
-
end
|
9
|
-
|
10
|
-
def push_alert_button
|
11
|
-
@autoit.WinWait @@ie_window_name, ""
|
12
|
-
@autoit.Send "{ENTER}"
|
13
|
-
end
|
14
|
-
|
15
|
-
def push_confirm_button_ok
|
16
|
-
@autoit.WinWait @@ie_window_name, ""
|
17
|
-
@autoit.Send "{ENTER}"
|
18
|
-
end
|
19
|
-
|
20
|
-
def push_confirm_button_cancel
|
21
|
-
@autoit.WinWait @@ie_window_name, ""
|
22
|
-
@autoit.Send "{ESCAPE}"
|
23
|
-
end
|
24
|
-
|
25
|
-
def push_security_alert_yes
|
26
|
-
@autoit.WinWait "Security Alert", ""
|
27
|
-
@autoit.Send "{TAB}"
|
28
|
-
@autoit.Send "{TAB}"
|
29
|
-
@autoit.Send "{SPACE}"
|
30
|
-
end
|
31
|
-
|
32
|
-
def logon(title,name = 'john doe',password = 'john doe')
|
33
|
-
@autoit.WinWait title, ""
|
34
|
-
@autoit.Send name
|
35
|
-
@autoit.Send "{TAB}"
|
36
|
-
@autoit.Send password
|
37
|
-
@autoit.Send "{ENTER}"
|
38
|
-
end
|
39
|
-
|
40
|
-
def WindowHelper.check_autoit_installed
|
41
|
-
begin
|
42
|
-
Watir.autoit
|
43
|
-
rescue
|
44
|
-
raise Watir::Exception::WatirException, "The AutoIt dll must be correctly registered for this feature to work properly"
|
45
|
-
end
|
46
|
-
end
|
47
|
-
end
|
48
|
-
|
49
|
-
|
1
|
+
require 'watir/win32ole'
|
2
|
+
require 'watir/ie' # for Watir.autoit
|
3
|
+
|
4
|
+
class WindowHelper
|
5
|
+
@@ie_window_name = "Windows Internet Explorer"
|
6
|
+
def initialize()
|
7
|
+
@autoit = Watir.autoit
|
8
|
+
end
|
9
|
+
|
10
|
+
def push_alert_button
|
11
|
+
@autoit.WinWait @@ie_window_name, ""
|
12
|
+
@autoit.Send "{ENTER}"
|
13
|
+
end
|
14
|
+
|
15
|
+
def push_confirm_button_ok
|
16
|
+
@autoit.WinWait @@ie_window_name, ""
|
17
|
+
@autoit.Send "{ENTER}"
|
18
|
+
end
|
19
|
+
|
20
|
+
def push_confirm_button_cancel
|
21
|
+
@autoit.WinWait @@ie_window_name, ""
|
22
|
+
@autoit.Send "{ESCAPE}"
|
23
|
+
end
|
24
|
+
|
25
|
+
def push_security_alert_yes
|
26
|
+
@autoit.WinWait "Security Alert", ""
|
27
|
+
@autoit.Send "{TAB}"
|
28
|
+
@autoit.Send "{TAB}"
|
29
|
+
@autoit.Send "{SPACE}"
|
30
|
+
end
|
31
|
+
|
32
|
+
def logon(title,name = 'john doe',password = 'john doe')
|
33
|
+
@autoit.WinWait title, ""
|
34
|
+
@autoit.Send name
|
35
|
+
@autoit.Send "{TAB}"
|
36
|
+
@autoit.Send password
|
37
|
+
@autoit.Send "{ENTER}"
|
38
|
+
end
|
39
|
+
|
40
|
+
def WindowHelper.check_autoit_installed
|
41
|
+
begin
|
42
|
+
Watir.autoit
|
43
|
+
rescue
|
44
|
+
raise Watir::Exception::WatirException, "The AutoIt dll must be correctly registered for this feature to work properly"
|
45
|
+
end
|
46
|
+
end
|
47
|
+
end
|
48
|
+
|
49
|
+
|