Watir::IE

开发测试案例（Developing Test Cases）
1.打开编辑器
2.以.rb为你的文件扩展名
3.在测试文件的第一句写上“require 'watir'”，确保可以访问Watir工具。
4.打开浏览器并转到要测试的应用
5.与之交互并设计你的testcase
6.在测试脚本中使用Watir方法
7.验证结果

与网页交互（Interacting With a Web Page）
当使用Watir开发测试脚本的时候，通过给网页上的对象发送消息来与之交互。

ie.text_field(:name , "q").set("bluescorpio")
ie.button(:value , "Click Me").click

Watir语法（Watir Syntax）
1.使用Watir工具，需要在脚本中加上
require 'watir'

2.创建一个IE的测试实例
ie = Watir::IE.new
或者在创建的同时直接转到页面
ie = Watir::IE.start("http://mytestsite")
Watir使用start方法同时创建一个浏览器实例并转到一个页面。

3.页面导航
ie.goto("http://mytestsite")

4.操纵Web页面对象
4.1超链接
4.1.1使用Text属性点击超链接
ie.link(:text , "Pickaxe").click
对应的HTML代码为：
<a href="http://pragmaticprogrammer.com/titles/ruby/">Pickaxe</a>
4.1.2使用URL属性点击超链接
ie.link(:url , "http://pragmaticprogrammer.com/titles/ruby/").click
对应的HTML代码为：
<a href="http://pragmaticprogrammer.com/titles/ruby/">Test Site</a>

4.2复选框
4.2.1使用name属性设置复选框
ie.checkbox(:name, "checkme").set
4.2.2使用name属性清除复选框
ie.checkbox(:name, "checkme").clear
4.2.3使用name和value属性设置复选框
ie.checkbox(:name, "checkme", "1").set
4.2.4使用name和value属性清除复选框
ie.checkbox(:name, "checkme", "1").clear
对应的HTML代码为：
<input type = "checkbox" name = "checkme" value = "1">

4.3单选框
4.3.1使用name属性设置单选框
ie.radio(:name, "clickme").set
4.3.2使用name属性清除单选框
ie.radio(:name, "clickme").clear
4.3.3使用name和id属性设置单选框
ie.radio(:name, "clickme", "1").set
4.3.4使用name和id属性清除单选框
ie.radio(:name, "clickme", "1").clear
对应的HTML代码为：
<input type = "radio" name = "clickme" id = "1">

4.4下拉框
4.4.1使用name属性和值来设置下拉框
ie.select_list( :name , "selectme").select("is fun")
4.4.2使用name属性和值来清除下拉框
ie.select_list( :name , "selectme").clearSelection
对应的HTML代码为：
<select name = "selectme" > <option name=1> <option name=2>Web Testing <option name=3>in Ruby <option name=4>is fun </select>

4.5在Web页面中输入数据

4.5.1使用文本输入框的那么属性设置输入内容
ie.text_field(:name, "typeinme").set("Watir World")
4.5.2清空文本输入框
ie.text_field(:name, "typeinme").clear
对应的HTML代码为：
<input type = "text" name = "typeinme" >

4.6从Web页面上提交数据
4.6.1按钮
4.6.1.1通过值或标题属性点击按钮
ie.button(:value, "Click Me").click
4.6.1.2通过name属性点击按钮
ie.button(:name, "clickme").click

对应的HTML代码为：
<input type = "button" name = "clickme" value = "Click Me">

4.6.2表单
4.6.2.1表单中的按钮
使用value或标题属性
ie.button(:value, "Submit").click
对应的HTML代码为：
<form action = "submit" name = "submitform" method="post"><input type = "submit" value = "Submit"></input></form>

4.6.2.2表单中的图片按钮
使用那么属性
ie.button(:name, "doit").click
对应的HTML代码为：
<form action = "submit" name = "doitform" method="post"><input type="image" src = "images/doit.gif" name = "doit"></form>

4.6.2.3没有按钮的表单
Watir can submit a form by identifying it by its name, action and method attributes.
可以通过name、action以及method属性来提交表单
ie.form(:name, "loginform").submit
ie.form(:action, "login").submit
对应的HTML代码为：
<form action = "login" name = "loginform" method="get"><input name="username" type="text"></input></form>

4.6.3框架
ie.show_frames可以打印出当前页面框架的数量和名称
Watir允许通过名称属性来访问框架，如ie.frame("menu")
如果要访问menu框架中的一个超链接，可以ie.frame("menu").link(:text, "Click Menu Item").click

4.6.4嵌套框架
ie.frame("frame1").frame(:name, "nested_frame")

4.6.5新窗口
一些Web应用会弹出新窗口或打开一个新窗口，可以使用attach方法来访问并控制新窗口。通过标示新窗口的URL或者title来访问。
ie2 = Watir::IE.attach(:url, 'http://mytestsite')
ie3 = Watir::IE.attach(:title, 'Test New Window')
也可以使用正则表达式
ie4 = Watir::IE.attach(:title, /Test New/)
注意：不要把新窗口分配到你的ie变量，最好给新窗口一个不同的名字

5.验证结果
比较好的方法是在测试案例中假如验证点
5.1对象存在
使用Watir方法contains_text
ie.contains_text("Reached test verification point.")

if ie.contains_text("Reached test verification point.")
  puts: "Test passed. Page contains the text: Reached test verification point."
else
  puts: "Test failed! Page didn't contain text: Reached test verification point."
end

5.2使用test::unit Assertions
5.2.1需要test::unit
require 'test/unit'

5.2.2创建测试实例
class TC_myTest < Test::Unit::TestCase
  ...fill in Test Case methods here...
end

5.2.3创建测试用例方法
在测试类中，需要声明象下面的方法：
def test_myTestCase
  fill in method body with Watir code and assertion here
end

方法必须以test开头，ruby会随机运行测试案例，如果需要顺序执行，需要在test后加上字母或数字来强迫它顺序执行，比如“test_a_mytest”

定义测试方法的类：
class TC_myTest < Test::Unit::TestCase
  def test_ myTestCase
    Watir code and assertion here...
  end
  def test_anotherTestCase
    Watir code and assertion here...
  end
  def test_aTestCase
    Watir code and assertion here...
  end
end

5.2.4使用Assertions
Watir通过在一个asert覆写Watir方法支持assertions。
assert(ie.contains_text("Reached test verification point.")

5.2.5Setup and Teardown
def setup
  fill in code that will run before every test case here...
end
def teardown
  fill in code that will run after every test case here...
end

6.Tips and Tricks
Running Tests With the Browser Not Visible
Run the tests with a "-b" option if you don't want the browser to be visible. ex. myTest.rb -b

 

  用watir控制ie的标准控件非常简单,以下参考了watir_user_guide文档,希望给大家有个参考:

1. 控制超级链接:
    源代码如：<a href=http://pragmaticprogrammer.com/titles/ruby/>Pickaxe</a>这样的代码,可以有两种方法来控制
2. 使用文本属性(Text Attribute)
   ie.link(:text, Pickaxe).click
3. 使用url属性
   ie.link(:url, http://pragmaticprogrammer.com/titles/ruby/).click
4. 控制checkbox:
   源代码如：<input type = checkbox name = checkme value = 1>，可以用两种方法进行控制：
5. 使用name属性：
   ie.checkbox(:name, checkme).set     #选中
   ie.checkbox(:name, checkme).clear  #清空
6. 使用name属性和value属性：
   ie.checkbox(:name, checkme,1).set     #选中
   ie.checkbox(:name, checkme,1).clear  #清空
7. 控制radio;
   源代码如：<input type = radio name = clickme id = 1>，可以用两种方法进行控制：
8. 使用name属性：
   ie.radio(:name, clickme).set     #选中
   ie.radio(:name, clickme).clear  #清空
9. 使用name属性和value属性：
   ie.radio(:name, clickme,1).set     #选中
   ie.radio(:name, clickme,1).clear  #清空
10. 控制选择框;
    源代码如:<select name = selectme > <option name=1> <option name=2>Web Testing <option name=3>in Ruby <option name=4>is fun </select>
11. 选择其中的一个属性：
    ie.select_list( :name , selectme).select(is fun)
12. 清空属性：
    ie.select_list( :name, selectme).clearSelection
13. 在web页的文本框中输入文本，可以通过name属性和id属性来进行识别和操作，如源代码：
    <input type = text name = typeinme >
14. 填充数据：
    ie.text_field(:name,typeinme).set(Watir World)
15. 清空数据：
    ie.text_field(:name, typeinme).clear
16. 提交数据，在web应用程序中，一般通过点击buttons按钮，图片按钮，或点击Enter/Return来提交数据，如：
17. 源代码为：<input type = button name = clickme value = Click Me>的方法可以使用name属性和value属性：
18. ie.button(:name, clickme).click    #利用name属性
19. ie.button(:value, Click Me).click    #利用value属性
20. Forms表单中的按钮，也可以通过name或者value属性来表示，源代码为：<form action = submit name = submitform method=post><input type = submit value = Submit></input></form>
21. ie.button(:value, Submit).click
22. Forms表单中的图片按钮，可以通过name属性来表示，如源代码为：<form action = submit name = doitform method=post><input type=image src = images/doit.gif name = doit></form>
23. ie.button(:name, doit).click
24. 有些Forms表单可能没有按钮进行提交，这时可以通过提交forms表单本身的name,action和method来实现,<form action = login name = loginform method=get><input name=username type=text></input></form>
25. ie.form(:name, loginform).submit
26. ie.form(:action, login).submit