10分鍾學會 Cucumber+Watir 自動化測試框架

　　估計你早已厭煩了成百上千遍的網頁點擊測試，至少之前的我是這樣的，那么，讓自己的web測試自動化吧，本文使用Cucumber ＋ Watir來完成自動化測試，從最簡單例子入手，一步一步重構成一個完整的自動化測試框架。

 

（一）Cucumber和Watir的關系

　　Cucumber和Watir可以沒有任何關系，Cucumber只是一個BDD框架，而Watir只是一個Web Driver而已，兩者的共同點是均屬於Ruby世界。

 

（二）單獨使用Cucumber

　　關於Cucumber的執行過程請參考筆者的另一篇文章：行為驅動開發: Cucumber的目錄結構和執行過程 。

　　由於Cucumber和Watir沒有必然聯系，因此兩者均可單獨使用，下面就讓我們用Cucumber來寫一個非常簡單的單元測試。 定義一個需要測試的Calculator類如下:

class Calculator
  def add num1, num2
    num1+num2
  end
end

   

　　用於測試Calculator類的add方法的feature文件如下：

Feature: Unit test for Calculator
2 
  Scenario: Add two numbers
    Given I have a calculator created
    When I add '3' and '5'
    Then I should get the result of '8'

 

　　對應的step文件為：

require File.join(File.dirname(__FILE__), "../calculator")
require 'rspec'
 3 
Given /^I have a calculator created$/ do
   @calculator = Calculator.new
end
 7 
When /^I add '([^"]*)' and '([^"]*)'$/ do |num1, num2|
  @result = @calculator.add(num1.to_i, num2.to_i)
end
11 
Then /^I should get the result of '([^"]*)'$/ do |expected_result|
   @result.should == expected_result.to_i
end

 

　　在以上的step文件中，第1，2行分別require了自定義的Calculator類和rspec(用於assertion,參考第13行的“should”), 第5行新建了一個@calculator實例變量，第9行完成兩個數相加(3+5)，第13行為測試斷言。運行cucumber命令，輸出結果如下：

Feature: Unit test for Calculator
 2 
  Scenario: Add two numbers             # features/Calculator.feature:4
    Given I have a calculator created   # features/step_definitions/calculator_step.rb:4
    When I add '3' and '5'              # features/step_definitions/calculator_step.rb:8
    Then I should get the result of '8' # features/step_definitions/calculator_step.rb:12
 7 
1 scenario (1 passed)
3 steps (3 passed)
0m0.002s

　　測試成功，沒有看到任何Watir的影子。

 

（三）單獨使用Watir

　　聽說有非常fashionable的office lady用Watir來完成日常例行並且繁瑣的網頁點擊工作的（當然不是測試），聽說而已，但是Watir的確可以完成諸如此類的網頁模擬操作，接下類我們就用Watir來完成google搜索功能，新建watir_google.rb文件並加入以下內容：

require 'watir-webdriver'
browser = Watir::Browser.new :chrome
browser.goto "www.google.com/"
browser.text_field(:name => "q").set "ThoughtWorks"
browser.button(:name => "btnG").click

 

　　當執行到第2行時，一個瀏覽器窗口會自動打開，之后訪問google主頁（第3行），設置搜索關鍵詞"ThoughtWorks",最后點擊搜索按鈕，單獨運行Watir成功，沒有任何Cucumber的影子。

 

（四）用Cucumber+Watir寫自動化測試

　　由上文可知，Cucumber只是用接近自然語言的方式來描述業務行為，而Watir則只是對人為操作網頁的模擬。當使用Cucumber+Watir實現自動化測試時，通過正則表達式匹配將Cucumber的行為描述與Watir的網頁操作步驟耦合起來即可。同樣以Google搜索為例，搜索關鍵字后，我們希望獲得搜索結果，先用Cucumber完成搜索行為描述：

Feature:Google search
Scenario: search for keyword
Given I am on google home page
When I search for 'ThoughtWorks'
Then I should be able to view the search result of 'ThoughtWorks'

 

　　對應的Watir代碼如下：

require "rubygems"
require "watir-webdriver"
 3 require 'rspec'

Given /^I am on google home page$/ do
  @browser = Watir::Browser.new :chrome
  @browser.goto("www.google.com")
end
 8 
When /^I search for  '([^"]*)'$/ do ｜search_text｜
  @browser.text_field(:name => "q").set(search_text)
  @browser.button(:name => "btnK").click
end
13 
Then /^I should be able to view the search result of '([^"]*)'$/ do |result_text|
 @browser.text.should include(result_text)
end

　　運行cucumber，一個新的瀏覽器被打開，顯示結果與（三）中相同。

（五）自動化測試的設計模式:Page對象

　　在上面的例子中，我們在所有的step中均直接對@browser對象進行操作，對於這樣簡單的例子並無不妥，但是對於動則幾十個甚至上百個頁面的網站來說便顯得過於混亂，既然要面向對象，我們就希望將不同的頁面也用對象來封裝，於是引入Page對象，既可完成對頁面的邏輯封裝，又實現了分層重用。此時位於high-level的Cucumber文件無需變動，我們只需要定義一個Page對象來封裝Google頁面（google－page.rb）：

require "rubygems"
require "watir-webdriver"
require "rspec"
 4 
class GooglePage
  def initialize
    @browser = Watir::Browser.new :chrome
    @browser.goto("www.google.com")
  end
10 
  def search str
    @browser.text_field(:name => "q").set(str)
    @browser.button(:name => "btnK").click
  end
15 
  def has_text text
    @browser.text.should include(text)
  end
end

  

　　相應的step文件需要做相應的修改：

require File.join(File.dirname(__FILE__), "google-page")
 2 
Given /^I am on google home page$/ do
  @page = GooglePage.new
end
 6 
When /^I search for '([^"]*)'$/ do |search_text|
  @page.search search_text
end
10 
Then /^I should be able to view the search result of '([^"]*)'$/ do |result_text|
   @page.has_text result_text
end

 

　　運行cucumber，一個新的瀏覽器被打開，顯示結果與（三）中相同。

（六）加入角色用戶

　　既然是行為驅動，既然是模擬用戶實際操作，那么直接對Page對象進行操作也顯得不夠了，於是我們引入了角色用戶User對象，對於擁有多種用戶角色的網站來說特別實用。加入User對象之后，step文件中不再出現對Page對象的直接引用，而是在User對象的行為方法中進行引用，定義User對象如下(user.rb)：

require File.join(File.dirname(__FILE__), "google-page")
 2 
class User
  def initialize
    @browser = Watir::Browser.new :chrome
  end
 7 
  def visit_google
    @page = GooglePage.new(@browser)
  end
11 
  def search_text text
    @page.search text
  end
15 
  def assert_text_exist text
    @page.has_text text
  end

  

　　feature文件保持不變，在step文件用User代替Page:

require File.join(File.dirname(__FILE__), "user")
 2 
Given /^I am on google home page$/ do
  @user = User.new
  @user.visit_google
end
 7 
When /^I search for '([^"]*)'$/ do |search_text|
  @user.search_text search_text
end
11 
Then /^I should be able to view the search result of '([^"]*)'$/ do |result_text|
  @user.assert_text_exist result_text
end

　　

　　運行cucumber，一個新的瀏覽器被打開，顯示結果與（三）中相同。 

　　對於擁有多個用戶角色的網站，比如又customer,administrator等，可分別對這些角色定義相應的對象，再在step文件中應用這些角色對象即可。

 

（七）用ruby的Module來封裝不同的行為功能

　　對於單個用戶來說，比如網上購物網站的customer，既要購物操作，又要能修改自己的profile，此時為了對這些不同的邏輯功能進行組織，可引入ruby中的Module來進行封裝，即將costomer的不同行為功能模塊封裝在不同的module中，然后在customer對象中include這些Module。為簡單起見，依然用Google搜索來進行演示，此時可將搜索功能加入到Module中，定義搜索module（search-behavior.rb）如下：

module SearchBehavior
 2 
  def visit_google
    @page = GooglePage.new(@browser)
  end
 6 
  def search_text text
    @page.search text
  end
10 
  def assert_text_exist text
    @page.has_text text
  end
14 
end

 

　　在User對象中include該Module：

require File.join(File.dirname(__FILE__), "search-behavior")
class User
  include SearchBehavior
  def initialize
    @browser = Watir::Browser.new :chrome
  end

  

　　對step文件和feature文件均不用修改，運行cucumber，一個新的瀏覽器被打開，顯示結果與（三）中相同。

 

（八）總結

　　我們可以在Cucumber對應的step文件中直接訪問Watir的API，這樣的確也能達到測試目的，但這樣的缺點在於缺少設計，於是我們引入Page對象來封裝不同的頁面，引入用戶角色管理不同的用戶行為，再引入Module來組織不同的功能模塊，最后重構成了一個簡單實用的自動化測試框架。