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"));