WatiN框架学习

WatiN 是一个源于 Watir的工具，开源且用于web测试自动化的类库。Web Application Testing in .NET. WatiN 通过与浏览器的交互来实现自动化，使用起来具有轻便，简单的特点。

　　WatiN.Core: WatiN的核心部分，与浏览器的交互都包含在此模块中。

　　WatiN.Core.DialogHandlers: 该命名空间提供用于操作浏览器对话框的对象。

　　WaitN.Core.Exceptions: 该命名空间里的对象用于处理各种异常。

WatiN的原理和其他web自动化测试工具基本类似，通过操纵浏览器和web页面中的DOM对象来实现模拟用户操作网页。WatiN封装了复杂的DOM操作并提供了大量的扩展，使对web网页的操作更灵活，更简便。

HTML元素与WatiN类的映射：

在编写测试代码之前，首先通过工具查看web页面中元素的信息，确定该元素的类型再通过映射关系确定使用WatiN中的类。

IE类：最基础，最重要的一个类，用于访问web页面中的元素以及操纵IE浏览器。

Goto(string): 导航到某个地址的网页

Close(): 关闭浏览器

ContainsText(string): 是否包含指定文本

CaptureWebPageToFile(string): 对当前web页截图并保存到指定位置

ClearCache(): 清除Cache

ClearCookie(): 清除Cookie

备注：使用IE类意味着在IE上做测试，由于WatiN最新版本也支持Firefox, 可以定义出一个Browser来从config文件中决定使用哪个浏览器：

第一步：定义IEStatic类，用于在Browser方法中定义IE浏览器时使用：

     public class IEStatic
     {
         private Browser browser;
         private int browserThreadId;
         private string browserHandle;

         public Browser Browser
         {
             get
             {
                 var currentThreadId = GetCurrentThreadId();
                 if (currentThreadId != browserThreadId)
                 {
                     browser = IE.AttachTo<IE>(Find.By("hwnd", browserHandle));
                     browserThreadId = currentThreadId;
                 }
                 return browser;
             }
             set
             {
                 browser = value;
                 browserThreadId = GetCurrentThreadId();
                 browserHandle = browser.hWnd.ToString();

             }
         }

         private int GetCurrentThreadId()
         {
             return Thread.CurrentThread.GetHashCode();
         }
     }

第二步：在WatiNTest类中定义Browser方法:

     public class WatiNTest
     {
         static Browser browser;
         static IEStatic ieInstance;
         public static string classPropertyName = "Classname";
         public static Browser Browser
         {
             get
             {
                 string browserType = ConfigurationManager.AppSettings["BrowserType"].ToString().ToLower();
                 browserType = browserType ?? "ie";
                 switch (browserType)
                 {
                     case "ie":
                         if (browser == null)
                         {
                             try
                             {
                                 browser = new IE();
                             }
                             catch
                             {
                                 CloseInternetExplorers();
                                 browser = new IE();
                             }
                             ieInstance = new IEStatic();
                             ieInstance.Browser = browser;
                             Logger.LogAction("New IE instance created, hWnd=" + browser.hWnd.ToString());
                         }
                         else
                         {
                             browser = ieInstance.Browser;
                         }
                         classPropertyName = "Classname";
                         break;
                     case "firefox":
                         if (browser == null) browser = new FireFox();
                         classPropertyName = "Class";
                         break;

                 }
                 return browser;
             }
         }

         public static void CloseInternetExplorers()
         {
             var processes = from process in Process.GetProcesses()
                             where process.ProcessName == "iexplore"
                             select process;

             foreach (var process in processes)
             {
                 try
                 {
                     process.Kill();
                     process.WaitForExit();
                     process.Close();
                     process.Dispose();
                 }
                 catch { }
             }
             browser = null;

         }
     }

将 Goto(string)重写成以下方法：

         public static void Navigate(string url)
         {
             browser.GoTo(url);
         }

其他常用方法：

ClearCookie方法：

         public static void ClearCookie()
         {
             using (IE ie = new IE())
             {
                 ie.ClearCache();
                 ie.ClearCookies();
             }
         }

Close方法：

         public static void Close()
         {
             if (browser != null)
             {
                 browser.Close();
                 browser.Dispose();
                 if (ieInstance != null)
                 {
                     ieInstance.Dispose();
                     ieInstance = null;
                 }
                 browser = null;
             }
         }

Find类：也是必须用到的一个类，用于查找并定位web页面中的元素

ById(), ByName(),  ByClass(), ByAlt(), ByText()….

一些例子，使用上面定义过的Browser方法来举例：

Link:

             Link link = WatiNTest.Browser.Link(Find.ByClass("string").Or(Find.ById("string")));
             string linkText = link.Text;
             string url = link.Url;
             link.Click();     

Button:

             Button button= WatiNTest.Browser.Button(Find.ById("string"));
             string buttonText = button.Text;
             button.Click();

Div:

Div div = WatiNTest.Browser.Div(Find.ByClass("string"));